PHP集成测试验证多个组件协作，如控制器、数据库、缓存、邮件服务等，以“用户注册并发送欢迎邮件”为例，涵盖HTTP请求、数据库写入、缓存操作、邮件调用及事务处理，并通过SQLite内存库、Mock服务和可重置环境确保测试可靠。
PHP集成测试不是只测单个函数或类，而是验证多个组件（比如控制器、服务、数据库、缓存、外部API调用）协作时是否按预期工作。它比单元测试更贴近真实运行环境，但又不像端到端测试那样依赖完整HTTP请求和前端渲染。下面以一个「用户注册并发送欢迎邮件」的典型业务流程为例，带你走完一次完整的PHP集成测试编写过程。
明确被测业务流程与关键集成点
先理清要测什么：用户提交注册表单 → 后端校验 → 创建用户记录到数据库 → 生成激活令牌 → 写入缓存（如Redis）→ 触发邮件服务异步发送欢迎信。这里面涉及：
- HTTP请求解析（如通过Slim/Laravel的Request对象）
- 数据库写入（PDO或ORM如Eloquent/Doctrine）
- 缓存操作（Predis/Redis扩展）
- 邮件服务调用（可能封装成MailerInterface，实际用SMTP或LogDriver）
- 事务边界与错误回滚逻辑
搭建轻量可重置的测试环境
集成测试需要真实依赖，但不能每次跑都连生产库或发真邮件。推荐做法：
- 用SQLite内存数据库替代MySQL：速度快、隔离性好，在
setUp()里执行迁移和初始数据 - 用Mockery或PHP内置Mock替换外部服务：比如把MailerInterface mock成记录日志而非发信
- 用临时Redis实例或Predis\Connection\StreamConnection('127.0.0.1:0')跳过真实缓存，或直接禁用缓存驱动
- 所有测试用例结束后调用
tearDown()清理状态，确保彼此不干扰
编写可断言的集成测试用例
以PHPUnit为例，写一个测试方法覆盖主路径：
立即学习“PHP免费学习笔记（深入）”；
public function testUserCanRegisterAndReceiveWelcomeEmail(): void
{
$email = 'test@example.com';
$password = 'secure123';
// 模拟邮件服务不真实发送，只记录调用
$mailer = Mockery::mock(MailerInterface::class);
$mailer->expects()->send(Argument::type(WelcomeEmail::class))->once();
// 替换容器中的服务（Laravel可用app()->instance()，Slim可用DI容器set）
$this->app->getContainer()->set(MailerInterface::class, $mailer);
// 发起模拟HTTP POST（可用HttpKernelTestCase或自定义RequestBuilder）
$request = Request::create('/api/register', 'POST', [
'email' => $email,
'password' => $password,
]);
$response = $this->app->handle($request);
// 断言响应状态和结构
$this->assertSame(201, $response->getStatusCode());
$this->assertJson($response->getBody()->getContents());
// 断言数据库已插入用户（查SQLite内存库）
$user = User::where('email', $email)->first();
$this->assertNotNull($user);
$this->assertTrue(Hash::check($password, $user->password));
// 断言缓存中存在激活令牌（假设用Redis存储）
$token = $this->redis->get("activation:{$user->id}");
$this->assertNotEmpty($token);
}
覆盖异常路径与边界场景
集成测试的价值常体现在对“失败流”的验证上：
- 邮箱已存在 → 应返回422且不创建用户、不发邮件
- 密码太短 → 数据库无写入，缓存无键，邮件未触发
- Redis连接失败 → 用户仍应创建成功，但激活流程降级（如改用DB存储令牌）
- Mailer抛出异常 → 记录错误日志，不影响注册主流程（需验证事务是否正确回滚或部分提交）
这些场景要在测试中显式构造条件（比如临时停掉Redis、mock mailer抛异常），再检查最终状态是否符合设计契约。
基本上就这些。集成测试写起来比单元测试稍重，但它能提前暴露组件间协议错位、配置遗漏、事务漏处理等问题。关键是控制变量——只让真正需要集成的部分动起来，其余尽量可控、可观察、可重置。
