转载请注明出处，如有问题请联系我们！ Composer 降级到 1.x 教程：老 PHP 项目依赖安装方案

Composer 降级到 1.x 教程：老 PHP 项目依赖安装方案 这篇文章适合维护老 Laravel、ThinkPHP、CMS 插件或旧 PHP 项目的用户。很多老项目在 Composer 2 下安装依赖会失败，并不是项目一定坏了，而是依赖规则和插件接口太旧。

一、为什么需要 Composer 1.x

Composer 2 性能更好，但部分老项目依赖写法、插件版本或锁文件只适配 Composer 1。常见表现包括：

• composer install 报依赖解析失败。
• 插件提示不兼容 Composer 2。
• 老项目要求 PHP5.6 或 PHP7.1。
• composer.lock 是很多年前生成的。

二、查看当前 Composer 版本

composer -V

输出类似：

Composer version 2.x.x

三、降级到 Composer 1

composer self-update --1
composer -V

如果成功，会显示 Composer 1.x 版本。

四、恢复 Composer 2

老项目装完依赖后，如果其他项目需要 Composer 2，可以恢复：

composer self-update --2
composer -V

五、安装依赖前先看 PHP 版本

Composer 版本只是一个因素，PHP 版本也很关键。先查看：

php -v

如果项目要求 PHP7.4，你用 PHP8.2，仍然可能报错。需要根据项目要求切换 PHP 版本。

六、composer install 和 update 的区别

• composer install：按 composer.lock 安装，适合生产环境。
• composer update：重新计算依赖版本，可能升级包，风险更高。

老项目上线建议优先：

composer install --no-dev

七、vendor 目录混乱怎么办

如果之前安装失败，vendor 目录可能已经不完整，可以重新安装：

rm -rf vendor
composer install --no-dev

不要随便删除 composer.lock，除非你明确知道依赖要重新解析。

八、国内服务器下载慢

可以配置镜像源：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

如果镜像源数据不同步，可以临时切回官方源。

九、常见错误

• PHP version does not satisfy：PHP 版本不满足。
• Plugin API version：Composer 插件版本不兼容。
• Allowed memory size exhausted：内存不足，可设置 COMPOSER_MEMORY_LIMIT。
• Package not found：包名错误或源不可用。

COMPOSER_MEMORY_LIMIT=-1 composer install

十、总结

Composer 降级到 1.x 是维护老 PHP 项目的常见手段，但不是万能解决方案。正确流程是先看 PHP 版本，再看 composer.lock，再决定是否降级 Composer。生产环境尽量使用 composer install，减少不可控升级。