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 composer.json
+
+
+
+
+
+ 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.
+
+