PHP：如何在多命名空间中同时使用带命名空间的类

我正在开发两款内部使用的WordPress插件，它们共用一套PHP类——目前的做法是把类文件复制到各插件后修改命名空间，运行正常。但后续要开发更多同类插件，打算将这套类放到Git子模块中共享。

核心问题：多个依赖该子模块的插件可能在同一站点启用，若子模块类使用独立命名空间，所有插件都会加载同一命名空间下的同名类，导致只有第一个加载的类生效（比如插件A的类被加载后，插件B也会复用A的版本）。如果子模块更新，旧插件可能因兼容问题报错。

需求：不修改子模块原文件的前提下，让每个插件加载自己版本的类，实现类隔离。当前使用Composer自动加载，每个插件的composer.json都配置了Submodule命名空间指向子模块目录，执行dump-autoload后出现上述冲突。

当前代码结构 #

子模块代码：

namespace Submodule;
class someClass {
    // 类方法实现
}

插件A代码：

namespace PluginA;
use \Submodule as PluginA_Submodule;

$classA = new PluginA_Submodule\someClass();
$classA->someMethod();

插件B代码：

namespace PluginB;
use \Submodule as PluginB_Submodule;

$classB = new PluginB_Submodule\someClass();
$classB->someMethod();

方案1：手动加载+动态替换命名空间 #

放弃Composer自动加载，手动读取子模块类文件内容，替换命名空间为当前插件的命名空间后执行，让每个插件生成独立命名空间下的类。

步骤 #

1. 子模块去掉命名空间（或保留但替换时覆盖）：

// 移除 namespace Submodule;
class someClass {
    // 类方法实现
}

2. 插件内编写加载函数，动态修改命名空间并加载：

namespace PluginA;

function load_submodule_class() {
    // 子模块类文件路径
    $submodule_file = __DIR__ . '/vendor/submodule/someClass.php';
    $content = file_get_contents($submodule_file);
    // 为类添加当前插件的命名空间
    $content = "namespace PluginA;\n" . $content;
    // 执行代码生成独立类
    eval('?>' . $content);
}

// 加载并使用类
load_submodule_class();
$classA = new someClass();
$classA->someMethod();

• 优点：完全隔离各插件的类版本，子模块无需修改；
• 缺点：使用eval需确保代码安全（内部插件风险可控），性能有微小损耗。

方案2：自定义自动加载器替代Composer自动加载 #

保留子模块原命名空间，通过自定义自动加载函数，在加载子模块类时动态替换为当前插件的命名空间，避免类冲突。

步骤 #

插件内注册自定义自动加载器：

namespace PluginA;

// 注册自动加载函数
spl_autoload_register(function ($target_class) {
    // 只处理当前插件需要的子模块类
    if ($target_class === 'PluginA\someClass') {
        $submodule_file = __DIR__ . '/vendor/submodule/someClass.php';
        $content = file_get_contents($submodule_file);
        // 替换子模块命名空间为当前插件命名空间
        $content = str_replace('namespace Submodule;', 'namespace PluginA;', $content);
        eval('?>' . $content);
    }
});

// 直接使用当前命名空间下的类
$classA = new someClass();
$classA->someMethod();

插件B同理，将PluginA替换为PluginB即可。

方案3：子模块类改为无命名空间，通过命名空间包裹加载 #

子模块类去掉命名空间，插件加载时将类包裹在自身命名空间内（本质和方案1类似）：

namespace PluginA;

// 读取子模块文件内容，包裹到当前命名空间
$content = file_get_contents(__DIR__ . '/vendor/submodule/someClass.php');
eval("namespace PluginA;\n$content");

$classA = new someClass();
$classA->someMethod();

此方案同样实现类隔离，适合不想修改子模块太多内容的场景。

内容的提问来源于stack exchange，提问作者Shoelaced