Repository navigation
[imagick] Document installation with PIE - #53
Open
officialasishkumar wants to merge 2 commits into
Open
officialasishkumar wants to merge 2 commits into
officialasishkumar wants to merge 2 commits into
Conversation
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 php#23
GromNaN
reviewed
Nov 14, 2026
GromNaN
approved these changes
Nov 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The Imagick installation page only pointed to PECL, both for building from source and for the prebuilt Windows DLLs. Following the accepted RFC: Recommend PIE and deprecate PECL, this reworks it to document PIE, which Imagick supports as of 3.8.0 through the
imagick/imagickpackage.pie install imagick/imagick.--with-imagickconfigure option (taken from Imagick'scomposer.json) for non-standard prefixes.ext-imagickincomposer.jsonso thatpie installin the project directory offers to install it.php_imagick.dllintoextension_dirand copies the bundled ImageMagick DLLs next tophp.exe, so they no longer have to be added toPATHmanually. It also puts theconfig/*.xmlfiles inextras\imagick\config(behaviour taken from PIE'sWindowsInstall).extension_dir,PATHand ImageMagick configuration file instructions are kept.The structure follows the existing PIE sections of the yac and yar pages.
Validation:
php doc-base/configure.php --disable-libxml-check --enable-xml-details --redirect-stderr-to-stdout --with-base-lang=extensions;docbook-cson the diff; renderedimagick.installation.htmlwith PhD and checked the output.Fixes #23