Composer 不支持环境动态切换 require 或 autoload 配置，因其解析器不执行 PHP 代码，所有字段仅接受字符串字面量；真正可行的是三步法：移出环境专属模块、运行时 addPsr4 动态注册、严格管控 ClassLoader 实例生命周期。
Composer 本身不支持按环境动态切换 require 或 autoload 配置 —— 所有依赖声明和自动加载规则在 composer.json 中都是静态的，安装/更新阶段即固化。所谓“环境区分加载”，实际是靠组合策略实现的：用 composer install --no-dev 控制依赖范围，配合运行时条件判断 + PSR-4 动态注册，才能真正达成租户/环境级隔离。
为什么不能在 composer.json 里写 if-env 逻辑？
因为 Composer 的依赖解析器不执行 PHP 代码，require、autoload.psr-4 等字段只接受字符串字面量。常见错误包括：
- 试图写
"App\TenantA\": "modules/tenant-a/src/"在开发分支，上线后切到"App\TenantB\": "modules/tenant-b/src/"—— 这会导致composer install失败或类加载错乱，因vendor/autoload.php已按旧配置生成 - 在
autoload.files中引用带$_ENV或getenv()的文件 —— 这些变量在dump-autoload阶段不可用，文件不会被收录进autoload_files.php - 误以为
config.platform能控制自动加载路径 —— 它只影响依赖版本解析，不改变命名空间映射
真正可行的环境区分加载三步法
核心不是让 Composer “懂环境”，而是让它生成通用基础加载器，再由应用层补足差异化部分：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
基础依赖走
require，环境专属模块全部移出composer.json：比如tenant-a-feature-x不出现在任何require字段中，避免被 Composer 解析和安装 -
模块目录物理存在，但仅靠运行时
$loader->addPsr4()注册：例如 Laravel 中可在服务提供者里写：$loader = require __DIR__.'/../vendor/autoload.php'; if (config('tenant.id') === 'a') { $loader->addPsr4('App\TenantA\', base_path('modules/tenant-a/src/')); } -
必须检查是否已注册，避免重复污染
getPrefixesPsr4()：重复调用addPsr4()会导致同一命名空间映射多个路径，类加载行为不可预测
容易被忽略的生命周期陷阱
动态注册只对当前 ClassLoader 实例生效，而该实例通常在请求开始时创建（如 Laravel 的 app()->booted()），但不会跨进程持久化：
- PHP-FPM 子进程启动后，
autoload.php只加载一次；新增模块目录后，不重启 FPM 或重载容器，旧进程永远找不到新类 —— 这不是缓存问题，是ClassLoader实例没重建 - Docker 环境下若挂载了
modules/目录但未触发opcache_reset()或 FPM reload，class_exists()仍返回false - CLI 命令（如 Artisan）与 Web 请求使用不同生命周期，需确保两者都执行了相同的注册逻辑，否则出现“Web 能加载、命令行 Class not found”
最关键的不是怎么写配置，而是清楚谁在什么时候持有哪个 ClassLoader 实例 —— 所有“明明文件在、也调了 addPsr4 却找不到类”的问题，几乎都卡在这里。
