From 47236ffc2799454f6ead65912e19c8636a688e86 Mon Sep 17 00:00:00 2001 From: Asish Kumar Date: Sat, 14 Nov 2026 12:02:14 +0000 Subject: [PATCH 1/2] [imagick] Document installation with PIE The accepted RFC "Recommend PIE and deprecate PECL" makes PIE the recommended installation method for non-bundled extensions, and Imagick ships PIE support (the imagick/imagick package on Packagist) as of 3.8.0. The installation page however still only pointed to PECL, both for building from source and for the prebuilt Windows DLLs, and did not mention PIE at all. Rework the installation section to: - recommend `pie install imagick/imagick`, with an example; - explain that on non-Windows platforms PIE builds from source, so the ImageMagick development files must be present, and document the --with-imagick configure option for non-standard prefixes; - show how a project can declare ext-imagick in composer.json and let `pie install` offer to install the missing extensions; - describe what PIE does on Windows: it downloads the prebuilt package from the GitHub release, installs php_imagick.dll into extension_dir and copies the bundled ImageMagick DLLs next to php.exe; - point manual Windows downloads to the GitHub releases page, which hosts the same packages PIE uses, instead of PECL, keeping the existing instructions about extension_dir, PATH and the ImageMagick XML configuration files, and noting where PIE places those configuration files (extras\imagick\config); - keep a pointer to the PECL package for releases older than 3.8.0, which cannot be installed with PIE. Fixes #23 --- reference/imagick/setup.xml | 93 +++++++++++++++++++++++++++++++------ 1 file changed, 80 insertions(+), 13 deletions(-) diff --git a/reference/imagick/setup.xml b/reference/imagick/setup.xml index d64d67fc2..c7736ffaf 100644 --- a/reference/imagick/setup.xml +++ b/reference/imagick/setup.xml @@ -26,23 +26,90 @@ &pecl.moved; - &pecl.info; - &url.pecl.package;imagick. + As of Imagick 3.8.0, the recommended way to install this extension is + with &link.pie;, the PHP Installer for Extensions, using the + imagick/imagick + package. + + + Installing Imagick with PIE + + + + + + On non-Windows platforms, PIE builds the extension from source, so the + ImageMagick development files have to be installed beforehand. + If ImageMagick is installed in a non-standard location, its installation + prefix can be passed with the + configure option. + + + Installing Imagick with PIE against a custom ImageMagick prefix + + + + + + When a project declares the extension as a requirement in its + composer.json, running pie install + without any argument in the project directory checks the extensions + required by the project and offers to install the missing ones. + + + Requiring Imagick in a project's <filename>composer.json</filename> + + + + + + On Windows, PIE downloads a prebuilt package matching the PHP version, + thread safety and architecture of the target PHP installation instead + of building the extension. + The extension DLL (php_imagick.dll) is installed into the + extension_dir, + and the bundled ImageMagick DLLs are copied next to + php.exe. + + + The same prebuilt Windows packages can also be downloaded manually from the + GitHub releases + page. + In that case, the extension DLL needs to be put into the + extension_dir + and renamed to php_imagick.dll, + and the ImageMagick DLLs need to be put somewhere in the PATH. + + + As of Imagick 3.6.0, the prebuilt Windows packages also contain ImageMagick + XML configuration files in config; when installing with + PIE, these are copied to extras\imagick\config in the + PHP installation directory. + To use these instead of the built-in defaults, they need to be put into + %USERPROFILE%/.config/ImageMagick, or alternatively in + the path given by the environment variable MAGICK_CONFIGURE_PATH. + Refer to the ImageMagick configuration files documentation + for further details. The official name of this extension is imagick. - - Windows users can download prebuilt DLL from the PECL website. - These packages already contain the extension DLL (php_imagick.dll) - which needs to be put into the extension_dir. - They also contain the ImageMagick DLLs, which need to be put somewhere in the PATH. - As of Imagick 3.6.0, they also contain XML configuration files in config; - to use these instead of the built-in defaults, they need to put into %USERPROFILE%/.config/ImageMagick, - or alternatively in the path given by the environment variable MAGICK_CONFIGURE_PATH. - Refer to the ImageMagick configuration files documentation - for further details. - + + + Releases prior to Imagick 3.8.0 can be found in the + Imagick PECL package. + + From 86ee09028f11d80925cecde338ec28da5a42431b Mon Sep 17 00:00:00 2001 From: Asish Kumar Date: Sat, 14 Nov 2026 21:32:24 +0530 Subject: [PATCH 2/2] [imagick] Use a version constraint in the composer.json example --- reference/imagick/setup.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/imagick/setup.xml b/reference/imagick/setup.xml index c7736ffaf..b1b93e0c5 100644 --- a/reference/imagick/setup.xml +++ b/reference/imagick/setup.xml @@ -66,7 +66,7 @@ pie install imagick/imagick --with-imagick=/opt/imagemagick