真隔离只有一条路：每个项目用独立ClassLoader实例且互不共享PSR-4/classmap注册表；因ClassLoader是全局单例，require vendor/autoload.php会将其注册进spl_autoload_register全局队列，导致路径错乱或优先级覆盖。
单机运行多个不同版本的 PHP 项目（比如 v1 和 v2 的 API 服务、租户隔离应用或灰度测试环境），不能靠改 composer.json 或硬塞多个 vendor/ 目录来“假装隔离”——ClassLoader 是全局单例，一旦注册，后续所有类加载都走同一套映射。真隔离只有一条路：每个项目用独立 ClassLoader 实例，且互不共享 PSR-4/classmap 注册表。
为什么 require 'vendor/autoload.php' 会破坏隔离
绝大多数人直接 require 各自项目的 vendor/autoload.php，但这个文件本质是返回一个 ComposerAutoloadClassLoader 实例并调用 register()。问题在于：register() 把加载器挂进 PHP 的 spl_autoload_register 全局队列，**后注册的会覆盖前一个的优先级，或并行执行导致路径错乱**。
- 两个项目同时 require 自己的 autoload.php → 两个 ClassLoader 都注册进 spl_autoloader，new AppV1Client() 可能被 V2 的 PSR-4 规则匹配到
- 即使你删掉 vendor/autoload.php 里的
$loader->register()，手动调用$loader->loadClass()也容易漏掉依赖链中的第三方类 - 别指望
unset($loader)能卸载已注册的 autoloader —— PHP 不提供反注册接口
正确做法：为每个项目创建独立 ClassLoader 并禁用自动注册
核心是绕过 vendor/autoload.php 的默认行为，自己控制加载器生命周期。每个项目需独立实例，且不调用 register()。
- 在项目入口（如
web/v1/index.php）中：$loader = require __DIR__.'/../v1/vendor/autoload.php'; $loader->unregister(); // 关键：先解除全局注册 // 然后手动设置命名空间映射（可选，用于覆盖） $loader->addPsr4('App\', __DIR__.'/../v1/src/'); // 最后显式加载类（非自动触发） $loader->loadClass('App\V1\Client'); - 若需自动加载，必须自己封装一层：
$loader->setPsr4('App\', [__DIR__.'/src/']); spl_autoload_register(function ($class) use ($loader) { $loader->loadClass($class) ?: false; });注意：这个spl_autoload_register是你自己的闭包，不是 Composer 默认注册的那个 - 绝对不要在同一个 PHP 进程里混用多个
vendor/autoload.php—— 即使加了include_once，ClassLoader 内部的 static 属性（如$prefixLengthsPsr4）仍是共享的
多租户场景下更安全的替代方案：动态 vendor 目录 + 运行时切换
当你要在同一个 SaaS 应用里支持租户 A（用 monolog/monolog:^2.0）和租户 B（用 monolog/monolog:^3.0），靠 ClassLoader 隔离已不够——vendor 目录物理冲突、autoload 文件互相覆盖。
- 每个租户必须有独立
composer.json和独立vendor/目录，生成命令带-d参数：composer install --no-scripts --no-dev -d "tenants/tenant-a/" - 运行时按租户 ID 动态引入对应
vendor/autoload.php，但必须确保每次只加载一个：$tenantAutoload = "tenants/{$tenantId}/vendor/autoload.php"; if (file_exists($tenantAutoload)) { $loader = require $tenantAutoload; $loader->unregister(); // 防止与其他租户冲突 // 注册专属 autoloader spl_autoload_register([$loader, 'loadClass']); } - 关键限制：不能跨租户共享类实例（如
new TenantALogger()传给TenantBService）——类名相同但来自不同 vendor，PHP 视为完全不同的类
最容易被忽略的坑：OPcache 和 class_alias 导致的隐性污染
即使 ClassLoader 隔离成功，PHP 的 OPcache 仍可能缓存旧类定义，尤其在 CLI 模式下未重启进程时；而 class_alias() 创建的别名是全局生效的，不受 ClassLoader 控制。
- Serverless 或 CLI 场景下，务必在切换项目前执行
opcache_reset()（仅开发/测试环境启用） - 避免在隔离环境中使用
class_alias('AppV1Client', 'Client')—— 别名会写入全局符号表，下次加载 V2 版本时可能命中 V1 的别名 - 检查
php.ini中opcache.enable_cli=1是否开启，开启时每次 CLI 脚本启动都会复用缓存，必须手动清理
