不能直接覆盖 vendor 目录，因 Composer 清空旧目录再写入会触发 PHP 类未找到或文件加载失败；应通过时间戳+哈希生成独立 release 目录并用软链接原子切换，同步重置 opcache、确保路径动态解析、权限正确及缓存清理。
为什么不能直接覆盖 vendor 目录
直接 composer install 到线上 vendor/ 目录，会导致正在运行的 PHP 进程加载到一半就失效——因为 Composer 会先清空旧目录再写入新文件，而 PHP 的 opcache 或已 require 的类文件可能正依赖其中某个被删掉的 .php 文件，立刻抛出 Class not found 或 Failed opening required 错误。
更隐蔽的问题是：如果部署期间有请求进来，PHP 可能读到半新半旧的依赖状态（比如 A 包已更新、B 包还没写完），引发难以复现的逻辑错乱。
- PHP 不支持原子性替换整个目录（尤其在 ext4/xfs 下）
-
opcache.revalidate_freq默认 2 秒，意味着错误可能持续数秒甚至更久 - 即使加了部署锁，也无法阻止已加载进内存的类定义被意外覆盖
用软链接切换 vendor 的核心步骤
本质是把 vendor/ 变成指向实际版本目录的符号链接，每次部署生成全新 vendor-20241105-123abc 目录，最后用 ln -snf 原子切换链接目标。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 部署前先创建带时间戳+哈希的独立 vendor 目录：
composer install --no-dev --optimize-autoloader --prefer-dist -d /var/www/app/releases/20241105-123abc - 确保
autoload.php路径不硬编码：应用入口应通过dirname(__DIR__) . '/vendor/autoload.php'加载，而非固定路径 - 切换时用
ln -snf /var/www/app/releases/20241105-123abc/vendor /var/www/app/current/vendor，-n避免链接嵌套，-f强制覆盖 - 切换后立即执行
opcache_reset()（需在 CLI 环境下触发，或通过 Webhook 调用专用重载脚本）
需要同步处理的关联文件
只换 vendor/ 不够。Composer 生成的自动加载文件、二进制脚本、资源路径都可能被缓存或硬引用。
-
vendor/autoload.php是入口，必须随目录一起切换；但vendor/composer/autoload_*.php是自动生成的，无需单独管理 -
vendor/bin/下的命令行工具（如phpunit、laravel）必须和当前vendor/版本严格对应，否则执行时报错Class 'Composer\Autoload\ClassLoader' not found - 若项目用了
composer dump-autoload --classmap-authoritative，则 classmap 是静态的，必须确保该命令在目标 release 目录中执行，不能复用旧 classmap -
storage/、bootstrap/cache/等运行时目录不能放在 release 子目录里，得挂载为共享卷或用绝对路径指向全局位置
常见陷阱与绕过方案
看似简单，实操中几个点容易漏掉导致零停机失败：
- Web 服务器（Nginx/Apache）工作进程以特定用户运行，要确保该用户对新
vendor-目录有读取权限，且umask不导致权限丢失（建议部署脚本末尾加chmod -R g+rX） - 某些框架（如 Laravel）会在
bootstrap/cache/config.php中缓存vendor/路径，部署后需清空该缓存或禁用配置缓存 - Docker 环境下若用 bind mount 挂载
vendor/，软链接会被宿主机解析失败，必须改为挂载releases/父目录，再在容器内做软链 - CI/CD 流水线若并行构建多个 release，注意
composer.lock时间戳或哈希冲突，建议在 release 目录名中加入 Git commit short SHA
软链接本身是原子操作，但它的安全前提是所有依赖路径都动态解析、无硬编码、无残留缓存——任何一个环节卡住，都会让“零停机”变成“零感知故障”。
