diff --git a/bundles/media/imagine-adapter.rst b/bundles/media/imagine-adapter.rst index 1766a966..7803b938 100644 --- a/bundles/media/imagine-adapter.rst +++ b/bundles/media/imagine-adapter.rst @@ -10,6 +10,13 @@ Available adapters are: * `imagick_extension`_ * `vips_extension`_ +.. note:: + + You may need to install additional libraries on your operating system to support various image MIME types, + such as ``libjpeg-dev, ``libpng-dev``, ``libwebp-dev``, ``libavif-dev``. + + Note that some Linux distributions, like Alpine, do not include these libraries in their base images by default. + GD -- @@ -18,6 +25,7 @@ The simplest adapter is GD and it has no external dependencies besides the PHP e **Docker:** To use the GD extension, you need to install it with docker-php-ext-install. However, GD requires Linux libraries to function properly. Depending on the type of file you want to generate (such as JPG, PNG, or WebP), you also need to install the corresponding libraries. + ..code-block:: bash RUN apt-get update && apt-get install -y \ @@ -28,7 +36,6 @@ To use the GD extension, you need to install it with docker-php-ext-install. How && docker-php-ext-configure gd --with-freetype --with-jpeg --with-webp \ && docker-php-ext-install -j$(nproc) gd \ - Imagick ------- @@ -47,8 +54,8 @@ To install it use following commands: .. code-block:: bash - apt-get install libmagickwand-dev inkscape - pecl install imagick + apt-get install libmagickwand-dev + apt-get install php8.3-imagick VIPS ---- @@ -71,7 +78,6 @@ To install it use following commands: .. code-block:: bash apt-get install libvips-dev - pecl install vips composer require rokka/imagine-vips .. _gd: http://php.net/manual/en/book.image.php