PHP: rfc:adopt_pie_deprecate_pecl

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== PHP RFC: Recommend PIE and deprecate PECL ======
  * Version: 0.1
  * Date: 2025-08-20
  * Author: James Titcumb, asgrim@php.net
  * Status: Draft

===== Introduction =====

The RFC proposes to deprecate PECL, and to adopt PHP Installer for Extensions (PIE) going forward.

===== Proposal =====

The proposal is made of two key messaging changes:

    * PECL becomes formally deprecated as the recommended installation method for non-bundled PHP Modules and Zend Extensions. This is in messaging only, and practically, the PECL tool and website (https://pecl.php.net/) will still function for the time being.
    * PIE is adopted formally as the recommended installation method for non-bundled PHP Modules and Zend Extensions.
    
Where possible, messaging will be added to PECL resources (such as the PECL website, the tool itself, PHP documentation, etc.) that PECL is deprecated and switching to PIE is recommended. A link to the PIE GitHub repository (https://github.com/php/pie) is recommended to provide a call to action to the user.

An example of this messaging can be seen in this Pull Request to the pecl.php.net website https://github.com/php/web-pecl/pull/108. This message would be updated to reflect the actual deprecation of PECL.

===== Backward Incompatible Changes =====
There are no breakages. PECL will continue to function.

===== Proposed PHP Version(s) =====
Not applicable - if accepted, this will take effect immediate.

===== Future Scope =====
This RFC specifically does NOT propose a timeline for removing the PECL website or CLI tool. These will continue to operate as they do currently. A follow-up RFC should be made to propose a timeline for their eventual removal, and methods by which this will be communicated to as many people as possible.

===== Voting Choices =====
Yes / No vote requiring 2/3 Yes votes to pass.

<doodle title="Deprecate PECL and adopt PIE instead?" voteType="single" closed="true" closeon="2025-01-01T15:30:00Z">
   * Yes
   * No
</doodle>

===== References =====
    * PIE project - https://github.com/php/pie
Page Tools
