Composer在单机运行多版本项目时隔离ClassLoader的方法-composer-PHP中文网

真隔离只有一条路：每个项目用独立classloader实例且互不共享psr-4/classmap注册表；因classloader是全局单例，require vendor/autoload.php会将其注册进spl_autoload_register全局队列，导致路径错乱或优先级覆盖。

composer在单机运行多版本项目时隔离classloader的方法

单机运行多个不同版本的 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()。

SSL

配置HTTPS，管理TLS证书，并调试安全连接问题。

下载

在项目入口（如 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 脚本启动都会复用缓存，必须手动清理