rfc:adopt_pie_deprecate_pecl

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.

Deprecate PECL and adopt PIE instead?
Real name Yes No
Final result: 0 0
This poll has been closed.

References

rfc/adopt_pie_deprecate_pecl.txt · Last modified: by asgrim