部署和协作必须用 composer install,开发中升级依赖才用 composer update;前者读取 composer.lock 安装精确版本,后者重算依赖树并更新 lock 文件。

composer install 和 composer update 到底该用哪个
部署和协作必须用 composer install,开发中升级依赖才用 composer update。前者只读 composer.lock,装的是锁文件里写死的精确版本;后者忽略 lock,重算整个依赖树,还改 lock 文件——CI/CD 脚本里出现 composer update,等于把构建结果交给网络和时间。
常见错误现象:composer install 报 “Your requirements could not be resolved”,大概率不是依赖冲突,而是本地 PHP 版本或扩展缺失(比如缺 ext-mbstring),因为 install 根本不决策版本,只照单执行。
- 首次运行
composer install时若无composer.lock,它会自动 fallback 到update并生成 lock——这绕过团队共识,建议初始化后立即git add composer.lock - 线上环境、新同事拉代码、CI 流水线,一律用
composer install - 想验证某包新版兼容性、修安全漏洞、升主框架(如 Laravel 10 → 11),才在本地跑
composer update
加依赖别手写 composer.json,用 require 就对了
composer require 是“声明 + 安装 + 锁定”三步合一的操作,不是下载快捷方式。手写 JSON 极易出错:引号漏写、逗号多写、版本约束符缺失,都会导致后续命令失败。
参数选错等于埋雷:
- 开发工具(如
phpunit/phpunit、phpstan/phpstan)必须加--dev,否则进require区,上线也会加载 - 指定版本别只写
7.5,得带约束符:composer require guzzlehttp/guzzle:^7.5(推荐)或~7.5.0;写成7.5等价于严格等于7.5.0,几乎匹配不到任何包 - 只想改
composer.json但不安装?加--no-update:composer require symfony/console --no-update
autoload 不生效?先跑 dump-autoload
90% 的 Class not found 报错,不是命名空间或路径错了,而是自动加载映射没刷新。Composer 不监听文件增删,新增 PSR-4 目录、改了 autoload 配置、或加了 files 类全局函数文件,都必须手动运行 composer dump-autoload。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
典型场景:你在 app/Helpers/ 下写了新工具类,composer.json 里配了 "files": ["app/Helpers/functions.php"],但跑起来报错——这时候不是 autoload 漏了,是没重生成映射。
- 开发中频繁加类又不想每次
update?加-o生成 classmap:composer dump-autoload -o,比默认 PSR-4 查找更快 - 用了
filesautoload(比如src/functions.php),改了那个文件也得重dump-autoload,否则不会生效 - 不确定是否全量刷新?加
-a:composer dump-autoload -a
换国内镜像源总配不对?记住 repo.packagist 这个 key
换源本质是改 repo.packagist 配置项,但很多人写成 repositories.packagist,多写了 repositories.,导致配置无效。
正确写法:
- 全局生效(推荐):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 仅当前项目生效:
composer config repo.packagist composer https://mirrors.aliyun.com/composer/(写进本项目composer.json的config字段) - 验证是否生效:
composer config --global --list | grep repo或composer config --list看输出里有没有你设的 URL
配置错一次,后续所有 require、update 都走慢速官方源,但错误提示不明显,容易被忽略。










