迁移PEAR包到Composer需优先查找Packagist上的现成替代包，无则自行封装为PSR-4私有包；替换PEAR特有函数与路径为原生PHP实现；采用渐进式策略，通过class_alias桥接、新旧并存、测试验证确保行为一致。
将旧的PEAR包迁移到Composer，核心是用Composer替代PEAR的安装、依赖管理和自动加载机制。PEAR本身已停止维护，迁移不仅是技术升级，更是项目长期可维护性的保障。
确认PEAR包是否已有Composer版本
很多经典PEAR包（如HTTP_Request2、Mail_Mime）早已被社区移植为Composer包，并发布在Packagist上。先搜索packagist.org，查是否有官方或广泛采用的替代包：
- 搜索关键词如
pear-http-request2或直接试php-http/client-implementation这类现代标准接口实现 - 优先选带
phpunit/phpunit这类明确维护者（如PHP-FIG成员、知名组织）的包 - 注意看
require中PHP版本和扩展依赖是否兼容你当前环境
若无现成Composer包：封装为私有包
如果该PEAR包无人维护、也未被移植，可自行打包供Composer使用：
从 Git 仓库历史中彻底删除文件
下载
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
- 将PEAR包源码（含
package.xml）整理为标准PSR-4结构，例如：src/MyPkg/Http/Request.php - 编写
composer.json，声明autoload（推荐PSR-4）、type（如library）、license等字段 - 托管到Git仓库（GitHub/GitLab），并在
composer.json中添加仓库配置（repositories）或直接提交到Packagist（需注册） - 安装时执行：
composer require vendor/name:dev-main（或指定tag）
处理PEAR特有的运行时行为
PEAR包常依赖PEAR::setErrorHandling()、PEAR::raiseError()或全局$_PEAR变量，这些在Composer环境下不自动存在：
- 移除对
PEAR.php的require_once，改用Composer自动加载 - 将
PEAR::raiseError()替换为throw new Exception(...)或自定义异常类 - 如有硬编码路径（如
PEAR_INSTALL_DIR），改为用__DIR__或配置驱动的路径 - 检查是否调用
System::mktemp()等PEAR特有工具函数——需用PHP原生函数（如sys_get_temp_dir()）替代
逐步替换与测试策略
避免一次性全量替换导致故障，推荐渐进式迁移：
- 先在
composer.json中保留PEAR安装（不影响现有运行），同时引入新Composer包 - 新建一个功能模块，用新包重写，并通过单元测试验证行为一致
- 使用
class_alias()临时桥接旧类名到新类（仅限过渡期），减少代码改动范围 - 确认无误后，删除PEAR安装（
pear uninstall xxx）并清理所有require_once 'PEAR.php'等残留
基本上就这些。关键不是“能不能装上”，而是确保行为不变、错误处理不丢、路径不崩、测试全过。PEAR到Composer不是换命令，是换整套依赖哲学。
