
本文介绍在不触及其他生产依赖的前提下,精准升级 composer 项目中 require-dev 包的高效方法,包括命令行技巧、安全注意事项及推荐实践。
本文介绍在不触及其他生产依赖的前提下,精准升级 composer 项目中 require-dev 包的高效方法,包括命令行技巧、安全注意事项及推荐实践。
在日常 PHP 开发中,我们常需单独更新开发阶段使用的工具类依赖(如 PHPUnit、PHPStan、php-cs-fixer 等),而保持 require 中的核心运行时依赖(如 Laravel、Symfony 组件等)版本锁定不变——这是保障生产环境稳定性的关键策略。遗憾的是,Composer 官方并未提供类似 --dev-only 的原生开关,但可通过组合命令精准实现该目标。
✅ 推荐方案:动态生成 dev-only 更新列表
以下单行命令可自动提取所有直接声明的开发依赖(即 composer.json 中 require-dev 下的包名),并仅对它们执行 composer update:
composer update $(composer show --name-only -D | grep -E -v "^($(composer show --no-dev --name-only -D | paste -sd '|' -))$")
? 命令解析:
composer show --name-only -D:列出所有直接依赖(含 dev)的包名(一行一个);composer show --no-dev --name-only -D:仅列出require中的直接依赖;paste -sd '|' -:将这些包名拼接为正则表达式中的“或”模式,如laravel/framework|monolog/monolog;grep -E -v "^(...)$":反向过滤,保留仅属于require-dev的包名;- 最终交由
composer update批量更新——全程跳过require包及其子依赖的版本变动。
✅ 优势:无需手动维护包名列表,兼容任意数量的 dev 依赖,且严格遵守 composer.lock 对非 dev 包的版本锁定。
⚠️ 注意事项与最佳实践
-
务必先提交当前
composer.lock:执行前确保工作区干净,避免意外覆盖锁文件; -
慎用
--with-dependencies:默认composer update不会递归升级 dev 依赖的子依赖(除非显式指定),若需深度更新,请加--with-all-dependencies并仔细验证; -
替代方案(更安全、可读性高):
可先导出 dev 包列表到临时文件,人工校验后再执行:# 生成待更新包列表 composer show --no-dev --name-only -D | sort > prod-deps.txt composer show --name-only -D | grep -v -F -f prod-deps.txt | sort > dev-only.txt # 查看并确认 cat dev-only.txt # 执行更新 composer update $(cat dev-only.txt | xargs)
-
CI/CD 场景建议:在测试环境使用
--no-interaction --no-progress参数提升稳定性。
✅ 总结
虽然 Composer 缺乏开箱即用的 --dev-only 标志,但借助其内置命令链与 Shell 工具,我们能可靠、可复现地实现开发依赖的独立升级。该方法既尊重了语义化版本约束,又规避了因全量更新引发的兼容性风险——是现代 PHP 工程化实践中值得纳入标准流程的实用技巧。











