Skip to content

Clarified PECL deprecation #5622

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
NickSdot wants to merge 2 commits into
base: master
Choose a base branch
from
+10 −5
Open

Clarified PECL deprecation #5622

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5233146
chore: clarify PECL deprecation
NickSdot Jun 18, 2026
fdd4fcf
Update language-snippets.ent
NickSdot Jun 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion install/pecl.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@

<chapter xml:id="install.pecl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Installation of PECL extensions</title>
&pecl.moving.to.pie;
Comment thread
NickSdot marked this conversation as resolved.

<sect1 xml:id="install.pecl.intro">
<title>Introduction to PECL Installations</title>
Expand Down Expand Up @@ -121,6 +122,7 @@ $ svn checkout https://svn.php.net/repository/pecl/extname/trunk extname

<sect1 xml:id="install.pecl.windows">
<title>Installing a PHP extension on Windows</title>
&pecl.moving.to.pie;
<para>
There are two ways to load a PHP extension on Windows: either compile it into
PHP, or load the DLL.
Expand Down Expand Up @@ -327,6 +329,7 @@ Loaded Configuration File C:\Program Files\PHP\8.2\php.ini

<sect1 xml:id="install.pecl.pear">
<title>Compiling shared PECL extensions with the pecl command</title>
&pecl.moving.to.pie;
<simpara>
PECL makes it easy to create shared PHP extensions.
Using the
Expand Down Expand Up @@ -377,6 +380,7 @@ $ pecl install extname-0.1

<sect1 xml:id="install.pecl.phpize">
<title>Compiling shared PECL extensions with phpize</title>
&pecl.moving.to.pie;
<simpara>
Sometimes, using the <command>pecl</command> installer is not an option.
This could be because there is a firewall or because the extension being
Expand Down Expand Up @@ -427,7 +431,7 @@ $ make
<title>
<command>php-config</command>
</title>

&pecl.moving.to.pie;
<para>
<command>php-config</command>
is a simple shell script for obtaining information about the installed PHP
Expand Down Expand Up @@ -540,6 +544,7 @@ Options:

<sect1 xml:id="install.pecl.static">
<title>Compiling PECL extensions statically into PHP</title>
&pecl.moving.to.pie;
<simpara>
It may be necessary to build a PECL extension statically into the PHP binary.
To do this, the extension source will need to be placed under the
Expand Down
8 changes: 4 additions & 4 deletions language-snippets.ent
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2271,13 +2271,13 @@ for this <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> extension
<!ENTITY pecl.moved-ver 'This extension has been moved to the &link.pecl;
repository and is no longer bundled with PHP as of PHP '>

<!ENTITY pecl.moving.to.pie '<note xmlns="http://docbook.org/ns/docbook">
<!ENTITY pecl.moving.to.pie '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
PHP Installer for Extensions (<acronym>PIE</acronym>) is a new tool that will deprecate PECL.
We recommend using PIE to install extensions.
PECL is deprecated.
PHP Installer for Extensions (<acronym>PIE</acronym>) replaces PECL and is recommended to install extensions.
Find out more at <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://github.com/php/pie">https://github.com/php/pie</link>
</simpara>
</note>'>
</warning>'>

<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>This extension is <emphasis>unmaintained</emphasis>.</simpara>
Expand Down