Composer 已经是 PHP 的事实标准。会用不难,难的是理解它为什么这么做——尤其是 composer.json、composer.lock 与 autoload 三者的关系。
三个文件的分工
| 文件 | 作用 | 是否提交到仓库 |
|---|---|---|
composer.json |
声明依赖与自动加载规则 | 是 |
composer.lock |
锁定每个包的确切版本 | 是(应用项目) |
vendor/ |
实际安装的代码 | 否(写进 .gitignore) |
关键理解:install 按 lock 装,update 才会改 lock。生产环境部署一定要用 composer install,它严格按锁文件还原,保证多台机器版本一致;composer update 是升级操作,应该在开发环境跑完、测试通过再提交 lock。
版本约束怎么写
{
"require": {
"php": ">=7.4",
"monolog/monolog": "^2.9",
"guzzlehttp/guzzle": "~7.8"
},
"autoload": {
"psr-4": { "App\": "src/" },
"files": ["src/helpers.php"]
}
}
^2.9:允许 2.9 以上、3.0 以下,主版本不变,最常用;~7.8:允许 7.8 以上、8.0 以下,但只放行次版本补丁;1.2.*:只允许 1.2 系列;- 不加约束:等于允许任意版本,非常危险。
autoload 的两种常用方式
PSR-4 是主流:命名空间前缀映射到目录,类名对应文件名。改完配置要执行 composer dump-autoload 才会重新生成映射。
files 用于加载函数库,会在每次请求时包含,适合放全局辅助函数,但不适合放大量代码。
国内环境加速
# 切换镜像源(注意:镜像可能滞后,正式发布前建议用官方源再验一次)
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
composer install --no-dev --optimize-autoloader
常见问题
- 内存不足:临时提高
COMPOSER_MEMORY_LIMIT=-1,或php -d memory_limit=-1; - 版本冲突:用
composer why-not vendor/package 1.2.3查是谁挡住了升级; - lock 与 json 不一致:说明有人改了 json 没跑 update,CI 里应该加
composer validate。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。