Composer在多服务器环境下的同步管理-composer-PHP中文网

vs code remote-ssh终端中composer命令找不到，因非登录shell未加载~/.zshrc，需将composer路径（如~/.local/bin）加入path并source配置；若composer install卡在仓库加载，则需安装ca-certificates并配置cafile路径。

composer在多服务器环境下的同步管理

远程服务器上找不到 `composer` 命令

VS Code Remote-SSH 终端默认不加载 ~/.bashrc 或 ~/.zshrc，所以即使你在 SSH 里能敲出 composer，在 VS Code 里大概率报 command not found。

先运行 which composer 确认是否真没装——返回空就说明 PATH 没包含 Composer 路径。常见情况有两种：

用 curl -sS https://getcomposer.org/installer | php 装的，生成的是 composer.phar，得手动加软链或 alias
用 sudo apt install composer 装的，二进制在 /usr/bin/composer，但 shell 没读到这个路径

临时解决：运行 export PATH="$HOME/.local/bin:$PATH"（如果 Composer 放在 ~/.local/bin/composer）；永久解决：在 ~/.zshrc 末尾加这行，然后重连 Remote-SSH 或执行 source ~/.zshrc。

`composer install` 卡在 “Loading composer repositories…”

这不是网络慢，是 PHP 的 OpenSSL 扩展压根没读对系统 CA 证书路径，尤其在最小化安装的服务器上很常见。

先确认 CA 包是否装全：sudo apt update && sudo apt install -y ca-certificates；如果还卡，别硬等，分两步排查：

运行 php -m | grep openssl 看扩展是否启用
检查证书路径是否被识别：php -r "print_r(openssl_get_cert_locations());"，看 default_cert_file 是否指向 /etc/ssl/certs/ca-certificates.crt

稳妥做法是强制指定：composer config -g cafile /etc/ssl/certs/ca-certificates.crt。临时绕过（仅调试）：composer config -g secure-http false，但千万别提交进团队配置。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

本地改了 `composer.json`，远程怎么确保 `vendor/` 一致

VS Code Remote-SSH 会自动同步文件，但同步完直接 composer install 很可能失败——因为远程已有 vendor/ 和旧的 composer.lock，版本约束冲突时 Composer 会拒绝覆盖。

正确顺序是：

保存本地 composer.json 后，等 VS Code 右下角提示“同步完成”
登录远程终端，先跑 composer update --lock 更新锁文件（只改 composer.lock，不动 vendor/）
再跑 composer install，这时它才按新锁文件重建依赖

如果项目已上线、不允许 update --lock，那就删掉远程 composer.lock，再 composer install —— 但必须确保本地 composer.lock 已 commit 并推送到 Git，否则下次部署又不一致。

多台服务器 PHP 版本不一致，`composer install` 报平台需求错误

比如开发机是 PHP 8.2，而某台测试服务器还是 8.1，composer install 会直接中断并报 Your requirements could not be resolved...，这不是依赖冲突，是 Composer 在预检阶段就卡住了。

关键不是升级 PHP，而是让 Composer 跳过这次检查：

加 --ignore-platform-reqs：适合离线或版本差异明确的环境，但要自己确保扩展（如 ext-pdo）确实存在
更安全的做法是用指定 PHP 版本运行：/usr/bin/php8.1 /usr/local/bin/composer install，前提是目标服务器装了对应版本且路径正确
查路径别靠猜：find /usr -name 'php8.1' 2>/dev/null 或 ls -la /usr/bin/php*

别用 php -v 查完就以为万事大吉——那个输出只是默认软链指向的版本，composer 实际调用的可能是另一个。