必须先确认composer.lock已提交、platform要求匹配且vendor未被误删；否则composer install会退化为update导致版本漂移，或因扩展缺失/权限错误而失败。
直接用 composer install 部署 PHP 项目是可行的，但前提是项目已提交 composer.lock 文件且目标环境满足平台要求；否则极易出现版本漂移、扩展缺失或权限错误。
为什么不能只跑 composer install 就完事？
因为 composer install 的行为完全取决于是否存在 composer.lock：
- 有
composer.lock→ 按锁定文件精确还原依赖（安全、可重复） - 没有
composer.lock→ 自动退化为composer update，安装最新兼容版（危险！线上环境绝不能这样） - 即使有 lock 文件，若 PHP 版本、扩展（如
ext-gd、ext-opcache）不满足composer.json中的platform约束，也会报错或跳过关键包
部署前必须验证的三件事
别跳过检查，很多线上故障就卡在这一步：
- 确认
composer.lock已提交到 Git —— 它不是临时文件，是部署契约 - 运行
composer check-platform-reqs，确保目标服务器的 PHP 版本、已启用扩展与composer.json中声明的一致 - 检查
vendor/是否被 .gitignore 排除（应该被排除），且部署流程中没误删composer.lock
composer install 部署时推荐加的参数
默认命令太“裸”，加几个开关能避开 80% 的坑：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
立即学习“PHP免费学习笔记（深入）”；
-
--no-dev：不装require-dev里的包（如 PHPUnit、phpstan），减小体积、提升安全性 -
--prefer-dist：优先用压缩包而非 Git 克隆，下载快、校验强、适合弱网边缘节点 -
--optimize-autoloader（或简写-o）：生成优化的 classmap，避免生产环境 runtime 文件查找开销 -
--no-interaction（或-n）：禁用交互提示，适配 CI/CD 流程
完整推荐命令：composer install --no-dev --prefer-dist --optimize-autoloader --no-interaction
权限和目录初始化常被忽略
Composer 不管文件权限和可写目录，但 Laravel、Symfony 等框架启动时会直接失败：
-
storage/、bootstrap/cache/必须可写，但不能用chmod 777（安全风险） - 推荐在
post-install-cmd中用 PHP 脚本创建并设权，例如：@php -r "mkdir('storage', 0775, true);" - Windows 环境下
chmod无效，得用 PowerShell 或跨平台 PHP 逻辑处理 -
.env文件权限建议设为644或664，避免被 Web 服务器意外暴露
真正麻烦的从来不是命令本身，而是 lock 文件是否真实反映线上环境、平台约束是否被严格执行、以及可写目录是否在 install 后被正确初始化——这三处出问题，composer install 跑得再快也没用。
