PHP 8.0项目中如何替换不可修改的外部依赖类？

问题背景 #

在无Composer的PHP 8.0项目中存在以下外部依赖代码：

interface Contract
{
    public static function getFoo(): string;
}

class ExternalDependency implements Contract
{
    public static function getFoo(): string
    {
        return 'gnarf!';
    }
}

该ExternalDependency类被多个Service类继承使用，示例如下：

class Service extends ExternalDependency {
}

需求与尝试的问题 #

需要尽可能少改动代码，将ExternalDependency替换为自定义类MyFix。尝试使用class_alias实现：

class MyFix implements Contract {
    public static function getFoo(): string {
        return 'Foo';
    }
}

class_alias(MyFix::class, ExternalDependency::class);

class Service extends ExternalDependency {
}

但出现警告：

PHP Warning:  Cannot declare class ExternalDependency, because the name is already in use in test.php on line 23

实际场景中ExternalDependency是服务器外部路径的供应商文件，无法轻易删除或修改。

解决方案 #

方案1：自动加载拦截（通用无扩展方案） #

核心思路是在原ExternalDependency类被加载之前，注册自定义自动加载器，当PHP尝试加载该类时，直接定义我们的替代版本，跳过原文件的加载。

示例代码：

// 注册优先级最高的自动加载器，确保在原类加载前执行
spl_autoload_register(function ($className) {
    if ($className === 'ExternalDependency') {
        // 直接定义替代类，实现Contract接口
        class ExternalDependency implements Contract {
            public static function getFoo(): string {
                return 'Foo';
            }
        }
        return true; // 标记该类已处理加载
    }
}, true, true);

// 引入供应商文件（如果原类通过include/require加载）
// require_once '/path/to/external/ExternalDependency.php';

// 业务Service类无需修改
class Service extends ExternalDependency {
}

// 测试调用
echo Service::getFoo(); // 输出 "Foo"

方案2：runkit7扩展重定义（需环境支持） #

如果服务器允许安装扩展，可使用runkit7的runkit_class_redefine方法，在原类加载后直接重定义。注意需单独安装扩展，并在php.ini中开启runkit.internal_override配置。

示例代码：

// 先引入原外部类文件
require_once '/path/to/external/ExternalDependency.php';

// 重定义ExternalDependency类的实现
runkit_class_redefine(
    'ExternalDependency',
    [],
    [
        'getFoo' => function(): string {
            return 'Foo';
        }
    ]
);

class Service extends ExternalDependency {
}

echo Service::getFoo(); // 输出 "Foo"

关键注意事项 #

• 方案1是无依赖通用方案，必须保证自动加载器在原类加载前注册，若项目已有自动加载逻辑，需通过spl_autoload_register的第三个参数确保自定义加载器优先级更高。

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