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 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。