Composer如何使用PHP-Scoper隔离命名空间_Composer PHP-Scoper隔离命名空间攻略-composer-PHP中文网

php-scoper 不能自动生效，因为它不集成 composer 钩子机制，仅静态重写 php 文件命名空间；必须手动执行 php-scoper add-prefix 并配置 autoload 映射新路径。

composer如何使用php-scoper隔离命名空间_composer php-scoper隔离命名空间攻略

为什么 `php-scoper` 不能直接在 `composer install` 后自动生效

php-scoper 不是 Composer 的插件或钩子机制的一部分，它不修改 composer.json 的加载行为，也不干预自动加载器生成。它只做一件事：扫描 PHP 文件、重写命名空间和类引用，输出到新目录。所以哪怕你用 Composer 安装了 php-scoper，不显式运行它，vendor 里的代码依然保持原始命名空间，根本不会被“隔离”。

常见错误现象：Class 'SomeVendorPackageFoo' not found —— 实际是因为你改了 vendor 里类的命名空间，但没同步更新自动加载映射，也没重建 autoloader。

必须手动执行 php-scoper add-prefix，指定输入（如 vendor/）、输出（如 build/scoped-vendor/）和前缀（如 MyApp）
作用范围仅限于你传入的 PHP 文件路径，composer install 本身完全无感知
如果 scoped 后的代码要被项目加载，必须让 Composer 知道新路径——要么用 autoload-dev + psr-4 映射，要么用 classmap 指向 scoped 输出目录

如何让 scoped vendor 被项目正确加载

Composer 默认只加载 vendor/ 下的包，scoped 后的代码放在 build/scoped-vendor/ 这类路径下，不配置就等于“不可见”。最稳妥的方式是把 scoped 结果作为“本地包”纳入 autoload。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

在 composer.json 的 autoload 或 autoload-dev 中添加：
```
"psr-4": { "MyApp\Vendor\": "build/scoped-vendor/" }
```
运行 composer dump-autoload，确保新映射生效
注意：scoped 后所有原始命名空间（如 MonologLogger）都会变成类似 MyAppVendorMonologLogger，调用时必须用新全名，或通过 use MyAppVendorMonologLogger 导入
如果 scoped 目录里有 composer.json（比如你用了 --force-psr4 且保留了包元数据），可考虑用 path repo 方式 require，但多数场景没必要

`php-scoper` 配置文件里哪些键最容易配错

scoper.php 是核心控制点，但几个关键配置项稍不注意就会导致 scoped 失败或加载异常。

prefix 必须是合法命名空间（结尾不带），例如 'MyApp' ✅，'MyApp\' ❌（会多出双反斜杠）
whitelist 和 exclude-files 用相对路径，基准是 scoper.php 所在目录，不是项目根目录；写成 vendor/symfony/console/ 就可能漏匹配
patchers 如果用于修复硬编码字符串（如 '__DIR__ . "/vendor"），必须确保正则能覆盖所有变体，否则 runtime 报错 Cannot find file
默认会跳过 composer/autoload_*.php，但如果你 scoped 后又想用原 vendor 的 autoload（错误做法），会导致冲突——应该彻底弃用原 vendor 自动加载

scoped 后为什么有些扩展类仍报 `Class not found`

不是所有类都能被 php-scoper 安全重写。典型漏网之鱼包括：

PHP 扩展内置类（如 mysqli, Redis）——它们没有 PHP 源码，php-scoper 根本看不到，也不可能重命名
动态构造的类名：比如 $class = 'SomeOriginalClass'; new $class()，scoper 不解析运行时字符串，这类代码需要手动替换为 scoped 名称
注解（Doctrine Annotations）、PHPDoc 中的类名（如 @var SomeOriginalFoo）默认不处理，需开启 process-php-docs: true 并确认版本支持
Phar 内部或 eval() 中的代码无法被静态分析，scoped 后若还依赖这些路径，大概率失败