PHP主流架构如何做单元测试_工具与流程【详解】

发布日期： 2026-01-01 阅读量： 作者： 星夢妙者

Laravel用TestCase+refreshDatabase最顺；Symfony推荐KernelTestCase配轻量容器；自研架构须手动解耦依赖。phpunit须在项目根目录运行，bootstrap指向vendor/autoload.php。Eloquent测试应mockDB或抽Repository接口，避免连真实数据库。

PHP 主流架构（Laravel、Symfony、CodeIgniter 等）做单元测试，核心不是“能不能测”，而是“测什么”和“怎么让 phpunit 真正跑进你的业务逻辑里”。直接上结论：Laravel 用 TestCase + refreshDatabase 是最顺的路径；Symfony 推荐 KernelTestCase 配合轻量容器；纯 PHP 架构（如自研 MVC）必须手动解耦依赖，否则 new XxxService() 一写，测试就卡死。

为什么 `phpunit.xml` 配置常失效？

常见现象是 phpunit 报错找不到 TestCase 类，或 vendor/autoload.php 加载失败。根本原因不是配置文件写错了，而是当前工作目录不对，或 composer install 没在项目根目录执行。

phpunit 必须从项目根目录运行，不能在 tests/ 下直接执行
phpunit.xml 中的 bootstrap 路径要指向 vendor/autoload.php，不能写相对路径如 ./vendor/autoload.php
Laravel 项目若用 phpunit.xml.dist，需确认没被 .gitignore 忽略，且没被 IDE 自动重命名为 phpunit.xml 导致覆盖

如何让 Laravel 的 Eloquent 模型测试不连真实数据库？

很多人一写模型测试就 DB::table('users')->insert(...)，结果 CI 环境报错说 MySQL 连不上——这不是测试，这是集成测试。单元测试里，Eloquent 应该只验证逻辑，不碰真实连接。

用 RefreshDatabase trait（适合功能/集成级验证），但会清空并重建迁移，慢且依赖 DB 服务
更轻量的做法：mock DB facade，例如 DB::shouldReceive('table')->once()->andReturn(...)（需 orchestra/testbench 或 Mockery）
终极解耦：把数据库操作抽成 Repository 接口，测试时注入 mock 实现，$repo = Mockery::mock(UserRepository::class)

Symfony 项目中 `KernelTestCase` 启动太慢怎么办？

KernelTestCase 会加载整个 Symfony kernel，启动耗时常超 1 秒，导致单测执行缓慢。这不是配置问题，是设计使然——它本就为功能测试而生。

纯单元测试（比如验证一个 DTO 或 Validator）应继承 TestCase（PHPUnit 原生类），完全绕过 kernel
若必须用容器（如测试 service 依赖注入），改用 StaticWebTestCase 或手动构建轻量容器：$container = new ContainerBuilder(); $container->setParameter('kernel.debug', false);
避免在 setUp() 里重复调用 self::bootKernel()，它已在父类中执行一次

自研架构或 CodeIgniter 怎么补单元测试？

这类框架往往在控制器里直接 new Model()、$this->load->model()，导致无法替换依赖。强行写测试只会不断 patch 全局状态，越写越脆。

第一步：识别所有 new、static::、CI =& get_instance() 这类硬编码调用点
第二步：用构造函数注入替代全局访问，例如把 $this->db 改为 public function __construct(\CI_DB $db)
第三步：在测试中传入 Mockery::mock('CI_DB') 或 StubDb 类，控制返回值
别试图 mock $_POST 或 $_SESSION，改用封装类如 RequestInterface，再注入 mock 实例

class UserControllerTest extends TestCase
{
    public function testStoreReturns422WhenEmailInvalid()
    {
        $request = Mockery::mock(RequestInterface::class);
        $request->shouldReceive('getParsedBody')->andReturn(['email' => 'invalid']);
        
        $validator = new EmailValidator();
        $controller = new UserController($request, $validator);
        
        $response = $controller->store();
        $this->assertEquals(422, $response->getStatusCode());
    }
}

最难的从来不是写断言，而是让被测代码愿意被测——只要还存在 new、global、require_once 这类语句，测试就只能绕着走。重构比补测试更重要，也更急。

上一篇: Win11怎么打开注册表_Windows 11注册表编辑器启

下一篇: Windows10系统怎么查看系统版本_Win10运行win

PHP主流架构如何做单元测试_工具与流程【详解】

随便看看

南昌壹佳企网络通信有限公司