composer.json 不支持动态包名，租户专属模块须通过运行时 addpsr4() 动态注册 psr-4 命名空间，避免静态依赖冲突与加载失效。
composer.json 里不能写动态包名
Composer 的依赖解析发生在安装或更新阶段，所有 require 字段值必须是静态字符串，不支持变量、环境判断或运行时拼接。想在 composer.json 里写 "vendor/{$tenant}/module-a": "^1.0" 这类写法，会直接报错 Invalid package name —— 解析器根本不会执行 PHP 表达式。
常见错误现象：本地开发时手动改 composer.json 切换模块，上线后因分支/环境差异导致依赖不一致，composer install 失败或加载错版本。
- 模块化 SaaS 的「租户专属模块」必须通过运行时机制加载，而非 Composer 静态声明
- 所有租户共用的底层包（如
laravel/framework、spatie/multitenancy）才适合放在根composer.json中 - 租户私有模块应作为独立可安装包发布到私有仓库（如 Satis、Private Packagist），但不列入主项目依赖列表
用 Composer 自动加载 + 运行时注册 PSR-4 命名空间
核心思路是绕过 require，改用 Composer 的自动加载机制动态注册路径。关键函数是 ClassLoader::addPsr4()，它允许你在运行时把某个命名空间映射到任意物理路径。
使用场景：租户 A 启用 AppTenantModulesAFeatureX，租户 B 启用 AppTenantModulesBFeatureY，两者代码隔离，且不互相污染自动加载缓存。
- 确保租户模块目录结构符合 PSR-4（如
modules/tenant-a/src/FeatureX/Handler.php对应命名空间AppTenantModulesAFeatureX） - 在租户上下文初始化时调用
$loader->addPsr4('App\TenantModules\A\', base_path('modules/tenant-a/src/')) - 避免重复注册：检查
$loader->getPrefixesPsr4()是否已存在该命名空间，否则 autoload.php 可能被污染 - 注意性能：每次请求都注册会增加开销，建议在中间件或服务提供者中做单次注册（Laravel 中可用
app()->booted()控制时机）
composer dump-autoload 不会扫描动态路径
composer dump-autoload 只处理 composer.json 里 autoload 和 autoload-dev 声明的路径，对运行时用 addPsr4() 注册的路径完全无感知。这意味着：你加了新模块目录，不重启 PHP-FPM 或重载容器，旧进程仍无法找到新类 —— 不是 Composer 缓存问题，是 ClassLoader 实例生命周期问题。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见错误现象：模块文件已放到位，也调用了 addPsr4()，但抛出 Class not found；查日志发现 get_declared_classes() 里没这个命名空间。
- PHP-FPM 模式下，需确保每个 worker 进程都执行了注册逻辑（不能只在启动脚本里跑一次）
- Docker 环境中，挂载新模块代码后，必须重建或重启应用容器，不能只
docker cp文件进去 - 如果用 OPcache，还需调用
opcache_invalidate()清理相关文件缓存（但通常类未命中不走 OPcache，重点还是 ClassLoader 实例）
模块包版本冲突与 autoloader 优先级
当多个租户模块提供同一名字的类（比如都定义了 AppContractsPaymentGateway），谁先注册谁生效 —— Composer 的 ClassLoader 是按注册顺序匹配命名空间的，没有“覆盖”或“作用域隔离”机制。
使用场景：租户 C 和 D 都有自己的支付网关实现，但接口契约相同；若注册顺序错乱，可能 D 的实现被 C 的代码调用，引发意料外行为。
- 强制约定命名空间前缀带租户标识（如
AppTenantModulesCPaymentGateway），从设计上规避冲突 - 避免跨租户共享接口类：把契约提到主应用或独立 SDK 包中，租户模块只实现，不声明
- 不要依赖
class_exists()判断模块是否启用 —— 它只反映类是否可加载，不反映当前租户是否授权使用该模块
真正麻烦的是租户模块之间隐式耦合：一个模块偷偷 require 了另一个租户的私有包，Composer 不报错（因为不在根依赖里），但运行时炸在 new 那一行。这种依赖关系只能靠文档、CI 扫描或运行时反射校验，Composer 本身管不了。
