Composer如何区分环境加载_Composer环境区分加载策略要点-composer-PHP中文网

composer 不支持环境动态切换 require 或 autoload 配置，因其解析器不执行 php 代码，所有字段仅接受字符串字面量；真正可行的是三步法：移出环境专属模块、运行时 addpsr4 动态注册、严格管控 classloader 实例生命周期。

composer如何区分环境加载_composer环境区分加载策略要点

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 却找不到类”的问题，几乎都卡在这里。