必须在终端直接调用php解释器验证：先执行php -v确认cli sapi启用，再用php --ini定位cli专属php.ini，添加extension=xxx.so后重启终端，最后运行php test_cli.php检查扩展加载与函数调用是否成功。
要验证PHP 8.3扩展在CLI模式下能否正常加载并执行，必须绕过Web服务器直接在终端调用PHP解释器，否则无法暴露扩展的初始化行为、全局函数可见性及CLI特有的资源管理逻辑。你不能依赖phpinfo()网页输出，也不能用浏览器刷新来观察变化——所有调试线索只存在于终端回显、错误日志和返回码中。
确认PHP CLI环境已就绪
打开终端，执行：
php -v
看到类似 PHP 8.3.x (cli) 的输出，且末尾明确标注 cli，说明CLI SAPI已启用。如果只显示 PHP 8.3.x (fpm) 或报错 command not found，说明系统未安装CLI版本或PATH未包含php二进制路径。
接着运行：
php -m | grep your_extension_name
若无任何输出，代表扩展尚未被PHP CLI识别——这很常见，因为Web和CLI可能使用不同的php.ini配置文件。
定位并修改CLI专属php.ini
执行：
php --ini
注意输出中的 Loaded Configuration File 路径，它指向CLI实际加载的配置文件，通常不是/etc/php/8.3/apache2/php.ini，而是 /etc/php/8.3/cli/php.ini 或 /usr/local/lib/php.ini。
用文本编辑器打开该文件，在末尾添加一行：
extension=your_extension_name.so
【必须重启终端或新起shell进程】，否则php命令仍会读取旧缓存配置。直接在当前终端改完ini后立即执行php -m，很可能看不到新增扩展——这是因PHP CLI进程不自动重载配置。
编写最小化测试脚本
创建 test_cli.php：
if (!extension_loaded('your_extension_name')) {
fwrite(STDERR, "Extension 'your_extension_name' not loaded\n");
exit(1);
}
echo "Extension loaded successfully.\n";
// 调用你的扩展导出的任意一个函数，例如：
if (function_exists('your_ext_do_something')) {
var_dump(your_ext_do_something());
} else {
fwrite(STDERR, "Function 'your_ext_do_something' not found\n");
exit(2);
}
?>
保存后，在终端执行：
php test_cli.php
成功时应输出扩展加载确认信息及函数返回值；失败时STDERR会打印具体原因，且退出码非零——这是判断扩展是否真正可用的唯一可靠依据。
模拟真实CLI参数交互
很多扩展需响应命令行参数（如 --enable-async），而不仅是静态加载。此时需构造带参数的调用链：
第一步：在test_cli.php顶部加入参数校验逻辑：
if ($argc echo "Usage: php test_cli.php [--init|--check]\n";
exit(1);
}
第二步：根据$argv[1]分支调用不同扩展能力，例如 --init 触发扩展内部初始化流程，--check 执行健康检查回调。
第三步：终端执行：
php test_cli.php --check
这一步能暴露扩展在参数解析阶段是否崩溃——某些扩展在$_SERVER['argv']未被正确初始化时会 segfault，仅在CLI下复现，Web模式完全无感。
捕获段错误与内存泄漏
方法一：用gdb调试器启动PHP CLI进程：
gdb --args php test_cli.php
进入gdb后输入 run，若程序崩溃，gdb会停在出错行并显示堆栈。这对定位扩展C代码中的空指针解引用或use-after-free至关重要。
方法二：启用Zend内存调试器：
USE_ZEND_ALLOC=0 php -d zend.enable_gc=1 test_cli.php
【USE_ZEND_ALLOC=0 是关键开关】，它禁用PHP内存池，使扩展的malloc/free行为直接暴露给系统malloc调试工具（如valgrind），否则内存泄漏会被内存池掩盖。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
