Symfony 8.2 HTTP Recorder教程：录制外部接口并在PHPUnit中回放-php教程-PHP中文网

symfony 8.2的http recorder可以先记录真实http交互，再让phpunit从har文件回放响应。它适合需要稳定外部接口样本的测试，不会把所有未标注测试的网络请求一并接管。使用前需确认8.2开发分支及相应phpunit bridge配置已经就绪。

只在test环境启用录制器

# config/packages/http_client.yaml
when@test:
    http_client:
        recorder: true

录制器包装HTTP传输层，可覆盖默认客户端及作用域客户端。PHPUnit Bridge中的SymfonyExtension负责驱动流程；采用Symfony Flex的项目应检查配方是否已经写入phpunit.dist.xml。

Symfony官方HTTP Recorder测试环境配置示例

为需要样本的测试添加属性

use Symfony\Bridge\PhpUnit\Attribute\UseRecord;
use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
use Symfony\Contracts\HttpClient\HttpClientInterface;

final class HomePageTest extends KernelTestCase
{
    #[UseRecord]
    public function testExamplePage(): void
    {
        $client = static::getContainer()->get(HttpClientInterface::class);
        $response = $client->request('GET', 'https://example.com/');
        self::assertSame(200, $response->getStatusCode());
        self::assertStringContainsString('Example Domain', $response->getContent());
    }
}

属性用于选择记录文件，是否允许访问真实服务由运行时模式决定。示例请求的是公开示例域；首次missing录制会真实联网。保存为项目tests目录下的测试类后，可替换成业务接口及相应断言。

SYMFONY_HTTP_RECORDER=missing vendor/bin/phpunit --filter testExamplePage

明确四种运行模式

默认replay仅回放，缺少匹配请求时抛出HarEntryNotFoundException；missing只补录缺失请求；record重新发起请求并重写本次测试记录；passthrough真实联网但不读写记录。未加UseRecord的测试保持原来的请求行为。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

提交HAR前检查敏感内容

录制器默认会遮蔽Authorization、Cookie及常见密钥字段。项目专用令牌应通过redact补充，必要时用自定义redactor。请求匹配基于方法、URL和请求体，同样的请求按录制顺序回放。

回放响应中的敏感值也会被替换，依赖签名校验的测试需单独设计脱敏规则。确认记录里没有凭据后再纳入版本管理，不能把自动遮蔽当成已经审查全部业务数据。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！