WordPress PHP项目单元测试如何Mock外部核心函数get_the_title

现有代码核心问题 #

你的Module类直接和WordPress全局函数get_the_title强耦合，没有抽象层隔离，所以无法脱离WordPress环境运行独立单元测试。

推荐方案：依赖注入解耦（符合OOP设计原则） #

这是最适合大型项目的方案，完全隔离业务逻辑和WordPress核心实现，测试不需要加载任何WordPress代码。

步骤1：抽象数据查询接口 #

定义获取文章标题的抽象接口，业务类只依赖接口，不依赖具体实现：

interface PostRepositoryInterface {
    public function getTitle(int|bool $id): string;
}

步骤2：实现WordPress适配层 #

把调用WordPress核心函数的逻辑封装到独立的实现类中：

class WordPressPostRepository implements PostRepositoryInterface {
    public function getTitle(int|bool $id): string {
        return $id ? get_the_title($id) : '';
    }
}

步骤3：重构Module类 #

通过构造方法注入依赖，不再直接调用全局函数：

class Module {
    private string $title;

    public function __construct(PostRepositoryInterface $repository, int|bool $id = false) {
        $this->title = $repository->getTitle($id);
    }

    public function get_title(): string {
        return $this->title;
    }
}

步骤4：编写可独立运行的测试用例 #

直接模拟接口的返回结果，不需要依赖WordPress环境：

class ModuleTests extends TestCase {
    public function test_get_title_returns_title_if_id() {
        $mockRepo = $this->createMock(PostRepositoryInterface::class);
        $mockRepo->method('getTitle')
            ->with(1)
            ->willReturn('A Test Title');

        $module = new Module($mockRepo, 1);
        $this->assertSame('A Test Title', $module->get_title());
    }

    public function test_get_title_returns_empty_string_if_no_id() {
        $mockRepo = $this->createMock(PostRepositoryInterface::class);
        $mockRepo->method('getTitle')
            ->with(false)
            ->willReturn('');

        $module = new Module($mockRepo);
        $this->assertSame('', $module->get_title());
    }
}

实际线上使用时，传入WordPressPostRepository的实例即可正常调用WordPress核心功能。

临时方案：模拟全局函数 #

如果暂时不想重构现有代码，可以通过命名空间优先级覆盖全局函数，快速跑通测试。
假设你的测试类处于MyProject\Tests命名空间下，在测试文件中定义同名函数即可：

namespace MyProject\Tests;

// 同命名空间下的函数优先级高于根命名空间的WordPress核心函数
function get_the_title($id) {
    return match($id) {
        1 => 'A Test Title',
        default => ''
    };
}

class ModuleTests extends TestCase {
    public function test_get_title_returns_title_if_id() {
        $module = new Module(1);
        $this->assertSame($module->get_title(), 'A Test Title');
    }

    public function test_get_title_returns_empty_string_if_no_id() {
        $module = new Module();
        $this->assertSame($module->get_title(), '');
    }
}

该方案仅作为临时过渡使用，长期来看耦合问题没有解决，不适合大型项目维护。

开发建议 #

• 所有和WordPress核心交互的逻辑统一封装到适配层，业务类只依赖抽象接口，符合开闭原则，后续替换数据源不需要修改业务代码
• 单元测试仅覆盖你自己编写的业务逻辑，不需要验证WordPress核心函数的正确性，核心功能的测试WordPress官方已经完成
• 可以拆分测试类型：单元测试完全隔离外部依赖，跑速快；集成测试加载WordPress环境，验证适配层和核心功能的交互逻辑

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