composer 的 vendor-dir 不支持动态路径，必须用 composer_vendor_dir 环境变量实现时间戳式隔离；php 加载路径需严格匹配 vendor 目录，回滚依赖需目录隔离+符号链接+autoload 同步更新。
vendor-dir 不能直接带时间戳，因为 Composer 不支持动态路径
Composer 的 vendor-dir 是静态配置项，只在 composer.json 解析阶段读取一次，不支持变量、函数或运行时计算（比如 date("Y-m-d")）。你写 "vendor-dir": "vendor_20240520" 可以生效，但写成 "vendor-dir": "vendor_{{date}}" 或用脚本注入会直接失败——Composer 根本不解析这种模板。
常见错误现象：composer install 报错 Could not parse composer.json，或者安装后自动加载失效，因为 autoload.php 路径硬编码在生成的 vendor/autoload.php 和 vendor/composer/autoload_*.php 中，路径一变就找不到类。
- 真正可行的做法是：构建前用脚本生成唯一 vendor 目录名（如
vendor_$(date +%s)），再通过环境变量或临时重写composer.json来指定 - 不要试图在
composer.json里写 shell 命令或 PHP 表达式 - 注意：
composer dump-autoload生成的文件也绑定该 vendor 路径，换目录后必须重新运行
用 COMPOSER_VENDOR_DIR 环境变量替代 vendor-dir 配置
这是最干净、可脚本化的方案。Composer 原生支持 COMPOSER_VENDOR_DIR 环境变量，优先级高于 composer.json 中的 vendor-dir，且无需改配置文件。
使用场景：CI/CD 构建、本地多版本并行调试、回滚时快速切换已构建的 vendor。
- Linux/macOS 下直接执行：
COMPOSER_VENDOR_DIR=vendor_1716245890 composer install - Windows PowerShell：
$env:COMPOSER_VENDOR_DIR="vendor_1716245890"; composer install - 该方式不影响
composer.lock内容，也不污染项目配置，适合自动化流程 - 注意：PHP 脚本中 require
vendor/autoload.php时，路径要同步更新（不能写死vendor/autoload.php）
回滚依赖版本时，vendor 目录隔离比时间戳更关键
单纯给 vendor 加时间戳并不能实现“回滚”，真正需要的是：不同构建产出的 vendor 彼此独立、互不干扰，且能被应用代码精准加载。
容易踩的坑：
- 把多个
vendor_*目录堆在项目根下，但index.php还是写死require 'vendor/autoload.php'—— 永远加载不到旧版本 - 没清理旧 vendor，磁盘爆满；也没记录每个 vendor 对应的
composer.lockhash，导致无法确认哪个目录对应哪次发布 - 在生产环境用
COMPOSER_VENDOR_DIR启动，但没导出该变量到 PHP-FPM 或 Apache 环境，导致运行时仍找默认 vendor
建议做法：构建脚本中同时生成 vendor_1716245890 和一个指向它的符号链接 current_vendor，PHP 代码统一 require current_vendor/autoload.php；回滚只需 ln -sf vendor_1716245800 current_vendor。
PHP 自动加载路径必须与 vendor 目录严格匹配
哪怕 vendor 目录名正确，只要 require 路径和实际目录不一致，就会报 Class not found。Composer 不会帮你“猜” autoload 路径。
性能影响：每次切换 vendor 目录，都要重新生成 autoloader（composer dump-autoload --optimize），否则类加载慢；若用 classmap，还得多花几秒扫描。
- 不要用相对路径拼接：
require __DIR__.'/../vendor/autoload.php'→ 改为require $_SERVER['COMPOSER_VENDOR_DIR'].'/autoload.php'或从配置中心读取 - 检查
vendor/composer/autoload_static.php里的$vendorDir是否和当前目录一致（它会被硬编码进去） - 如果用了
composer install --no-autoloader，后续必须手动composer dump-autoload，否则 vendor 目录存在也白搭
时间戳只是表象，路径控制权、加载入口一致性、lock 文件与 vendor 的绑定关系，才是隔离和回滚真正卡住的地方。
