Composer自动加载不隔离，多站点共用PHP进程时会因全局注册导致类冲突、版本错乱；必须通过独立FPM pool+独立vendor目录或入口重置autoload实现隔离。
单机部署多站点时，Composer 自动加载本身不防污染——它默认不隔离，靠你手动划清边界。多个站点共用同一 PHP 进程（如 Apache mod_php 或 FPM pool 未分离）时，vendor/autoload.php 一旦被某个站点提前加载，它的 spl_autoload_register() 就注册进全局 autoload 队列，后续所有站点都走同一套映射表，极易发生类名冲突、版本错乱或 Cannot redeclare。
为什么 vendor/autoload.php 不能跨站点复用
Composer 的自动加载器是单例 + 全局注册机制：ClassLoader::getLoader() 返回唯一实例，spl_autoload_register() 绑定的回调函数对整个 PHP 请求生命周期有效。只要一个站点执行了 require 'vendor/autoload.php'，其他站点再 require 同一路径，不会重新注册，而是复用已有 loader —— 但它的 $prefixesPsr4 映射来自第一个站点的 vendor/composer/autoload_psr4.php，和第二个站点的 composer.json 完全无关。
- 常见错误现象：站点 A 加载了
monolog/monolog v2.10，站点 B 依赖v3.5，结果 B 运行时抛出Class not found或方法不存在 —— 因为 A 的 autoload_psr4.php 里根本没有 v3 的路径映射 - 更隐蔽的问题：两个站点都用了
App命名空间，但各自src/目录结构不同，loader 拼路径时固定查第一个站点生成的autoload_psr4.php，必然文件找不到 - CLI 场景下更危险：
php artisan tinker或phpunit在某站点目录下运行，会把该站点的 autoload 注册进当前进程，接着切到另一站点目录执行脚本，直接复用旧 loader
真正可行的隔离方案只有两种
别指望 Composer 自己做隔离，必须从运行时环境或加载逻辑上切断共享。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
推荐：每个站点独占 FPM pool + 独立
vendor/目录 —— 不是“共享 vendor”，而是每个站点都有完整副本。Nginx 配置中fastcgi_pass指向专属 pool，PHP 进程启动时只加载自己目录下的vendor/autoload.php，loader 实例天然隔离 -
次选：入口文件强制重置 autoload（仅限 CLI 或特殊网关场景） —— 在站点 B 入口第一行加
if (class_exists('Composer\Autoload\ClassLoader', false)) { spl_autoload_unregister(['Composer\Autoload\ClassLoader', 'loadClass']); }，再require 'vendor/autoload.php'。但这要求你确认前序代码没触发任何类加载，且不能用于 web SAPI（因 register/unregister 在请求间不清理） - 绝对不要：在同一个 FPM pool 下靠
chdir()切换目录后重新 require ——spl_autoload_register()是进程级的，loader 实例已存在，新 require 只是返回已有实例，映射表不会更新
autoload_psr4.php 被复用时怎么快速定位问题
当出现跨站点类加载异常，直接检查实际生效的映射文件，而不是猜配置。
- 在报错站点的入口加一行：
var_dump(include __DIR__.'/vendor/composer/autoload_psr4.php');，看输出数组里的键是否是你当前站点的命名空间（如'App\' => ['src/']），而不是隔壁站点的'SiteA\' => ['app/'] - 如果输出为空或路径不对，说明
vendor/autoload.php加载的是另一个站点的vendor/目录 —— 检查__DIR__是否指向正确根目录，或是否被set_include_path()干扰 - 运行
composer dump-autoload必须在对应站点根目录下执行，否则生成的autoload_psr4.php仍来自错误配置
最易被忽略的一点：即使你为每个站点建了独立 vendor/，若所有站点共用同一个 Composer 全局 autoloader（比如通过 composer global 安装的工具触发过 autoload），它的 loader 也会混入队列。验证方式：在任一站点入口加 var_dump(spl_autoload_functions());，确认列表里只有本项目的 loader 回调，没有额外的 Composer\Autoload\ClassLoader::loadClass 实例。
