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 应该只验证逻辑,不碰真实连接。
- 用
RefreshDatabasetrait(适合功能/集成级验证),但会清空并重建迁移,慢且依赖 DB 服务 - 更轻量的做法:mock
DBfacade,例如DB::shouldReceive('table')->once()->andReturn(...)(需orchestra/testbench或Mockery) - 终极解耦:把数据库操作抽成 Repository 接口,测试时注入 mock 实现,
$repo = Mockery::mock(UserRepository::class)
Symfony 项目中 KernelTestCase 启动太慢怎么办?
KernelTestCase 会加载整个 Symfony kernel,启动耗时常超 1 秒,导致单测执行缓慢。这不是配置问题,是设计使然——它本就为功能测试而生。
立即学习“PHP免费学习笔记(深入)”;
- 纯单元测试(比如验证一个 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 这类语句,测试就只能绕着走。重构比补测试更重要,也更急。











