Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

image.ini [ImageConverterSettings]

The settings of [ImageConverterSettings] in image.ini: ImageConverters, LockTimeout

Download as PDF

Address: https://doc.exponential.earth/learninminutes/exphelp/viewer/examples/ini-settings/image/ImageConverterSettings.md

On this page

image.ini [ImageConverterSettings]

The block [ImageConverterSettings] of settings/image.ini, with 2 setting(s).

Never edit settings/image.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

  • settings/override/image.ini.append.php for every siteaccess,
  • settings/siteaccess/<siteaccess>/image.ini.append.php for one siteaccess,
  • extension/<extension>/settings/image.ini.append.php in an extension (read when the extension is active).

ImageConverters

List of converters to use, each entry is the name of the converter
which is defined in a ini block.
You can use ImageMagick and GD handlers by default.
The order of the convertes are important since the first
applicable converter will be used. The last handler is
usually a fallback converter which can take care of most formats.

GD comes first: it is the image extension built into PHP, so it
converts in process, without starting an external program for
every image, and needs nothing installed beside PHP. It reads and
writes JPEG, PNG, GIF and WBMP and supports every geometry filter
the default aliases use.
ImageMagick stays in the list as the fallback. It is used for the
formats GD cannot read (for example PSD, TIFF, PDF or WebP) and for
the filters only it supports (for example flatten, resize,
filter/swirl or filter/noise), and it takes over completely when the
GD extension is missing or [GD] IsEnabled=false.
To prefer ImageMagick again, override the list in
settings/override/image.ini.append.php:
ImageConverters[]
ImageConverters[]=ImageMagick
ImageConverters[]=GD
The list can also contain converters which cannot work
on the installed server, the converter should check this
and tell the image system to not use it.

For any other converter make sure you have a INI section
with the same name as your converter's

For example :
ImageConverters[]=MyCustomConverter
[MyCustomConverter]
with the same INI variables as GD or ImageMagick INI sections

Default: a list of 2: GD, ImageMagick.

<?php /* #?ini charset="utf-8"?
# settings/override/image.ini.append.php
[ImageConverterSettings]
# an empty "ImageConverters[]" first replaces the shipped list; without it the items are added
ImageConverters[]
ImageConverters[]=GD
ImageConverters[]=ImageMagick
*/ ?>

LockTimeout

Seconds a process waits for the lock of one alias file while another process makes
that alias (one lock per alias file: the aliases of one image are made in parallel).
When the other process is done in time, its file is used as it is; when the wait
runs out, no alias is made by this request (a page in render mode shows no image
for it this time, content/image answers the placeholder). On a single server the
lock is a file lock (var/<site>/cache/imagealias-locks), on a database cluster
(eZDFS) the .generating entry of the alias file. 0 waits not at all.

Default: 60.

<?php /* #?ini charset="utf-8"?
# settings/override/image.ini.append.php
[ImageConverterSettings]
LockTimeout=60
*/ ?>

Generated by ./console exp:help:examples from settings/image.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x