diff --git a/reference/imagick/setup.xml b/reference/imagick/setup.xml index d64d67fc2..b1b93e0c5 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. + +