PHP 扩展管理工具 PIE

PHP PIE（PHP Installer for Extensions）是 PHP 官方推出的一款现代化扩展管理工具，旨在简化 PHP 扩展的安装与管理流程，被视为 PECL（PHP 扩展社区库）的潜在替代方案。

首个公开版本发布于 2023 年下半年，具体而言，其在 GitHub 上的首个正式发布版本（v0.1.0）于 2023 年 9 月推出。这一工具由 PHP 基金会主导开发，旨在为 PHP 扩展管理提供更现代化、自动化的解决方案，逐步替代传统的 PECL 工具。

自首次发布以来，PHP PIE 持续迭代更新，不断扩展支持的扩展范围并优化功能，截至目前（2025 年）已推出多个版本，成为 PHP 生态中备受关注的扩展管理工具。其发展节奏与 PHP 基金会对现代化工具链的推进策略相契合，进一步巩固了在 PHP 扩展管理领域的地位。

以下是其核心特性和使用要点：

核心特性

1.类似 Composer 的使用体验

采用简洁的命令行语法，类似composer的操作逻辑，例如：

pie install xdebug/xdebug  # 安装Redis扩展
pie install xdebug/xdebug:^3.2  # 安装指定版本的Xdebug

2.自动化处理流程

• 自动从 Packagist 获取扩展包，无需手动查找资源。
• 自动编译扩展（Linux/macOS）或使用预编译 DLL（Windows）。
• 自动修改 php.ini 配置文件，添加扩展加载指令（如 extension=redis）。

3.多 PHP 版本支持

可指定为不同 PHP 版本安装扩展，例如：

pie install mongodb/mongodb --php /usr/bin/php8.4  # 为PHP 8.4安装MongoDB扩展

4.与现代开发流程兼容

支持在 CI/CD 管道中自动化安装扩展，无缝融入项目的自动化部署流程。你可以在 shell 脚本中添加 pie install 命令，实现自动安装扩展，也可以在 Docker 配置中指定安装哪些模块。

使用前提

• 运行环境需 PHP 8.1 及以上版本（PIE 自身依赖），但可管理其他 PHP 版本的扩展。
• Linux/macOS 需安装编译工具链（如gcc、make）；
• Windows 依赖扩展作者提供的预编译 DLL。

安装与配置

1. 下载pie.phar（官方发布地址：GitHub）。
   curl -O https://github.com/php/pie/releases/latest/download/pie.phar

2. 配置为全局命令（Linux/macOS 太容易搞定，我们就以 Windows 为例）：

   • 将 pie.phar 保存到 D:\portable\pie\ 目录。
   • 创建 pie.bat 文件，内容为： php "%~dp0pie.phar" %*。
   • 将 D:\portable\pie\ 添加到系统环境变量 Path 中，这样就可以直接在命令行使用pie命令了。

3. 验证安装：在命令行中运行 pie -V，若显示版本信息则安装成功。

扩展安装位置

pie.phar 如果与执行php.exe在同一个目录，那么扩展默认安装到 ~/ext 文件夹中，否则默认安装到 pie.phar 所在目录的 ext 文件夹中。

适用场景与局限

• 推荐场景：
  • 基于 PHP 8.1 + 的新项目
  • 需要自动化管理扩展的 CI/CD 流程
  • 主流扩展（如 Redis、Xdebug、MongoDB）的安装管理
• 当前局限：
  • 扩展覆盖度不及 PECL，部分冷门扩展暂不支持（可在这里查看已支持的PHP扩展）
  • Windows 环境依赖预编译 DLL，部分扩展可能无法安装
  • 暂未提供扩展卸载功能，需手动操作