不能靠 composer.json 的 require 字段动态加载租户组件，因其解析不执行 PHP，变量语法非法；必须采用静态主干 + 运行时通过 $loader->addPsr4() 动态注册 PSR-4 命名空间的两层机制。
不能靠 composer.json 的 require 字段动态加载租户组件——那会直接报 Invalid package name 错误。必须拆成「静态主干 + 运行时加载」两层机制。
为什么 composer.json 里写不了租户变量
Composer 解析 composer.json 是纯文本阶段，不执行 PHP。像 "vendor/{$tenant}/module-a": "^1.0" 这种写法，连语法校验都通不过。常见错误现象包括：
- 本地手动改
composer.json切换模块，上线后 CI/CD 执行composer install直接失败 - 误以为环境变量或
.env能被读取，实际require字段完全无视运行时上下文 - 试图用
composer dump-autoload扫描新模块路径，但该命令只处理autoload块声明的路径，对运行时注册无效
用 ClassLoader::addPsr4() 动态注册命名空间
核心是绕过 require，在运行时把租户模块路径绑定到命名空间。关键函数是 $loader->addPsr4()，它属于 Composer 自带的 ClassLoader 实例。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保模块目录结构符合 PSR-4，例如
modules/tenant-a/src/FeatureX/Handler.php对应命名空间AppTenantModulesAFeatureX - 在租户上下文初始化处调用：
$loader->addPsr4('App\TenantModules\A\', base_path('modules/tenant-a/src/')) - 必须检查是否已注册：
in_array('App\TenantModules\A\', array_keys($loader->getPrefixesPsr4()))，否则重复注册会污染 autoload 缓存 - 注册时机建议放在
app()->booted()回调中（Laravel），保证只执行一次；PHP-FPM 下每个 worker 进程需独立执行该逻辑
租户模块部署与隔离的关键约束
租户私有模块不能进主项目 composer.json，但也不能裸放源码。正确路径是：
- 将租户模块作为独立包发布到私有仓库（如 Satis、Private Packagist），版本号按租户+功能打标，例如
tenant-a/feature-x:1.2.0 - 主项目不
require它们，仅约定统一入口命名空间（如全部以AppTenantModules{TenantId}开头） - 部署时把模块包解压到固定路径（如
modules/tenant-a/），并确保 Web 服务器有读取权限 - 模块内不得依赖主项目未声明的全局包；如有共用工具类，应抽离为根项目
require的共享包
最容易被忽略的是 ClassLoader 生命周期问题：addPsr4() 注册只对当前 PHP 进程生效。PHP-FPM 模式下，加了新模块、也调了注册函数，但旧 worker 进程仍无法识别——这不是缓存没清，是进程没重载。
