如何在PHPUnit中实现*.phpt测试文件的自动更新功能？

背景一：PHPUnit中的*.phpt测试 #

我近期阅读了一篇关于PHPUnit支持*.phpt测试的文章。
该测试方案的核心优势如下：

• PHPUnit开箱支持，无需编写自定义代码识别、处理*.phpt文件
• 采用行业通用的标准化格式，适配性强
• 可直接在cli命令中指定单个*.phpt文件执行测试

典型的*.phpt文件结构示例如下：

--TEST--
Basic arithmetic - addition
--FILE--
<?php
var_dump(42 + 1);
?>
--EXPECT--
int(43)

背景二：自更新测试夹具 #

此前我还了解到可通过传入cli变量的方式，让单元测试自动更新（覆盖）自身的夹具文件。
通过执行以下cli命令即可自动覆盖失败测试对应夹具中的预期输出部分：

$ UPDATE_TESTS=1 ./vendor/bin/phpunit

执行后可通过git diff对比变更，确认是功能迭代导致的预期变更则直接提交，反之则修复代码逻辑。该方案提出的夹具格式与*.phpt格式高度相似，实际也可根据项目需求自定义格式。

自更新夹具的优势：

• 可先编写空的"--EXPECT--"区块，执行测试后自动生成预期内容
• 功能迭代（如Bug修复、不兼容变更发布）后可自动批量更新测试用例
• 适合开发早期功能不稳定阶段，可频繁更新测试夹具
• 无需手动复制cli输出的差异内容更新用例

该方案的缺点：

• PHPUnit无内置支持，需编写自定义代码实现，多项目复用成本高
• 无法直接在cli中指定单个*.phpt文件执行自更新操作

咨询问题 #

请问PHPUnit是否内置了自动更新*.phpt测试文件的功能？如果没有内置支持，是否有其他合适的工具可以实现该需求？

回答 #

PHPUnit本身没有内置自动更新*.phpt测试文件中预期输出区块的功能。
如果要实现该需求，有两种成熟可行的方案：

1. 自行封装轻量实现
   基于PHPUnit的事件监听系统，几十行代码就能完成基础功能：

   • 新增测试失败事件监听器，筛选出phpt类型的测试用例失败场景
   • 从失败日志中提取实际输出内容
   • 匹配对应phpt文件的--EXPECT--（或--EXPECTF--/--EXPECTREGEX--）区块，用实际输出覆盖原有内容
   • 增加环境变量开关（比如保留UPDATE_TESTS=1的触发逻辑）避免误修改
     这种实现也天然支持单文件更新，只要执行测试时指定单个phpt文件路径，更新时也只会修改对应目标文件。

2. 使用第三方封装工具
   PHP社区有多个专门处理phpt文件的工具包，已经内置了自动更新预期输出的功能，直接安装引入即可使用，不需要自行开发，也支持跨项目复用。

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