必须为PHP扩展编写.phpt测试用例并用run-tests.php验证；需建tests/目录、遵循节格式（--TEST--、--EXTENSIONS--、--FILE--、--EXPECT--等）、支持--INI--配置和--SKIPIF--跳过逻辑。
如果您正在开发PHP扩展并需要验证其功能的正确性，则必须为扩展编写符合规范的测试用例。PHP官方推荐使用PHP源码中内置的PHP Test Framework（即run-tests.php）进行扩展测试。以下是编写PHP扩展测试用例的标准步骤：
一、准备测试环境与目录结构
PHP扩展测试用例需置于扩展源码根目录下的tests/子目录中，且所有测试文件必须以.phpt为扩展名。该结构是run-tests.php工具识别和执行测试的前提条件。
1、在扩展源码根目录下创建tests文件夹。
2、确保扩展已通过phpize、./configure、make完成编译，且.so文件可被extension=加载。
立即学习“PHP免费学习笔记（深入）”；
3、确认PHP源码树中的run-tests.php路径可用（通常位于php-src/scripts/phpize/run-tests.php或通过make test调用）。
二、编写标准.phpt测试文件
每个.phpt文件必须包含若干必需的节（sections），用于声明测试元信息、执行逻辑与预期输出。缺失关键节将导致测试被跳过或失败。
1、使用--TEST--节定义测试名称，内容应简洁描述功能点，例如Test myext_hello() function。
2、在--EXTENSIONS--节中列出本测试依赖的扩展名，每行一个，如myext；若依赖多个，需逐行列出。
3、通过--FILE--节编写PHP执行代码，调用待测函数或验证行为，末尾需有echo或var_dump输出可比对结果。
4、用--EXPECT--节严格声明期望的原始输出内容，包括换行符和空格；若允许多种输出，可改用--EXPECTF--或--EXPECTREGEX--。
三、使用INI指令控制测试上下文
某些测试需临时修改PHP配置（如启用调试、调整内存限制或加载其他扩展），可通过--INI--节注入运行时ini设置，确保测试环境隔离且可复现。
1、在--INI--节中写入键值对格式的ini指令，例如error_reporting=32767。
2、支持多行设置，每行一条指令，不可包含空行或注释。
3、若需禁用某扩展，可写入extension=后不带值，如extension=opcache前加; 无效，应使用zend_extension=配合完整路径或依赖--SKIPIF--逻辑判断。
四、添加跳过条件与平台适配
当测试仅适用于特定PHP版本、操作系统或扩展状态时，需用--SKIPIF--节提前判断并跳过，避免在不兼容环境中报错中断。
1、--SKIPIF--节内必须为合法PHP代码，且最终必须调用exit()或die()；若返回非空字符串，测试将被跳过并显示该字符串作为原因。
2、检查PHP版本可使用version_compare(PHP_VERSION, '8.2.0', '。
3、检测扩展是否加载可使用!extension_loaded('myext')，并配合die('skip myext not available');。
五、验证测试用例可执行性
在提交或集成前，必须手动运行单个测试以确认语法正确、输出匹配且无未定义行为，防止因拼写错误或节顺序错乱导致测试失效。
1、进入PHP源码目录，执行：./sapi/cli/php run-tests.php -q /path/to/myext/tests/myext_basic.phpt。
2、观察输出中的PASS、FAIL、SKIP标识，重点关注FAIL时的差异对比（diff）部分。
3、若出现UNEXPECTED OUTPUT，需核对--EXPECT--节内容是否与--FILE--实际输出完全一致（含末尾换行）。
