生产环境必须放弃 composer global,因其无法版本锁定、不参与 CI/CD、易引发线上事故;应将工具作为 require-dev 依赖写入项目 composer.json,通过 vendor/bin 调用,并在 Docker 构建中固定 PHP 环境与 lock 文件。

生产环境不能靠“全局依赖版本”来统一,必须放弃 composer global 的思路——它天然与项目隔离、无法版本锁定、不参与 CI/CD 流水线,是 PHP 依赖管理中最容易引发线上事故的惯性操作。
为什么 composer global 在生产环境完全不可用
全局安装的包(如 phpunit、laravel/installer、deployer/deployer)不会写入任何项目的 composer.lock,也不受项目 PHP 版本或扩展约束。这意味着:
- 同一台服务器上多个项目可能因全局命令版本冲突而失败(比如一个项目依赖
symfony/console ^5.4,另一个却运行了全局deployer带来的^6.0) - CI/CD 构建时无法复现全局环境,
composer global install不被 Docker 层缓存,每次构建都可能拉取不同版本 -
composer global安装路径通常为~/.composer/vendor/bin/,权限、用户上下文、PATH 配置在生产服务器上极难标准化
真正可行的生产环境依赖统一方案
核心原则:所有依赖必须绑定到项目本身,通过 composer.json + composer.lock + 明确的安装指令来控制。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 把原本想全局安装的工具,改用
require-dev写进项目composer.json(例如:"phpunit/phpunit": "^10.5"),然后通过vendor/bin/phpunit调用 - CI/CD 流水线中,始终执行
composer install --no-interaction --no-progress --optimize-autoloader --no-dev(生产环境跳过require-dev) - 若需跨项目复用 CLI 工具(如部署脚本),应封装为独立可执行 PHAR 包,或通过
composer create-project拉取带 lock 的专用工具仓库,而非依赖全局状态 - Docker 镜像构建时,应在
Dockerfile中固定 PHP 版本、扩展,并在RUN composer install前 COPYcomposer.lock和composer.json,确保分层缓存有效且结果可复现
常见误操作与对应修正
这些做法看似省事,实则埋下严重隐患:
- 在生产服务器上手动运行
composer global require laravel/envoy→ 应改为:将laravel/envoy加入主项目require-dev,用php vendor/bin/envoy执行 - CI 中用
composer global install然后调用phpunit→ 应改为:在项目根目录运行composer install --no-dev,再执行./vendor/bin/phpunit - 用
composer global update升级所有全局包 → 这个操作没有 lock 文件约束,等同于随机升级,必须禁用;团队应统一维护一份工具清单 repo,每个工具版本由 PR + CI 验证后发布
真正的“统一”,不是让所有项目共享同一个全局 bin 目录,而是让每个项目都拥有自己精确锁定的依赖树,并通过标准化构建流程消除环境变量干扰——这点在容器化和 GitOps 成为主流的今天,反而比过去更容易落地,也更不容妥协。

















