PHP 8.4扩展开发必须精准使用RINIT/RSHUTDOWN钩子管理请求级资源，需通过php -r验证支持，用ZEND_RINIT_FUNCTION宏注册，emalloc分配内存并efree释放，否则引发内存泄漏或502错误。
在PHP 8.4扩展开发中，必须精准控制每次HTTP请求生命周期内的资源分配与释放，否则会导致内存泄漏、句柄堆积或跨请求数据污染——尤其在启用JIT和OPcache的高并发场景下，RINIT/RSHUTDOWN钩子失效或误用会直接引发502错误或进程崩溃。
确认PHP 8.4运行时支持RINIT/RSHUTDOWN
进入PHP源码目录，执行php -r "echo PHP_VERSION . ' | ' . (defined('PHP_RINIT_FUNC') ? 'RINIT supported' : 'not defined') . PHP_EOL;"。若输出含“RINIT supported”，说明当前编译启用了请求级钩子；若无此提示，需重新编译PHP并确保未禁用--enable-maintainer-zts（多线程安全模式非必需，但ZTS开启时RINIT/RSHUTDOWN更稳定）。
【必须验证】PHP 8.4默认关闭RINIT/RSHUTDOWN以提升JIT性能，不手动启用则扩展无法注册请求级回调。
在zend_module_entry中注册RINIT与RSHUTDOWN
打开扩展主C文件（如myext.c），定位到zend_module_entry结构体定义处，在对应字段填入函数指针：
立即学习“PHP免费学习笔记（深入）”；
PHP_RINIT(myext), // 注意：不是PHP_MINIT
PHP_RSHUTDOWN(myext), // 注意：不是PHP_MSHUTDOWN
这两个函数必须声明为ZEND_RINIT_FUNCTION(myext)和ZEND_RSHUTDOWN_FUNCTION(myext)宏包裹的形式，否则PHP 8.4引擎拒绝加载扩展——旧版宏PHP_RINIT在8.4中已被标记为deprecated，直接使用将导致段错误。
在RINIT中初始化请求专属资源
第一步：声明全局静态指针用于存储本次请求的资源句柄
static void *request_resource = NULL;
第二步：在ZEND_RINIT_FUNCTION(myext)内分配资源
例如申请一块1KB的请求私有内存：request_resource = emalloc(1024);。这里必须用emalloc而非malloc，因为只有Zend内存管理器分配的内存才能被RSHUTDOWN自动识别并交由GC处理；用malloc分配的内存若在RSHUTDOWN中未显式free，将永久泄漏。
第三步：将资源绑定到当前请求上下文
调用zend_set_local_var_str("myext_request_ctx", request_resource, 1024, 0);——该操作使资源可被PHP脚本层通过debug_zval_dump($GLOBALS['myext_request_ctx'])访问，且在请求结束时自动解绑。
在RSHUTDOWN中安全释放资源
方法一：直接释放emalloc内存
if (request_resource) { efree(request_resource); request_resource = NULL; }
方法二：使用Zend清理注册机制（推荐）
在RINIT中调用zend_register_rshutdown_function(myext_rshutdown_cleanup);，并在外部定义void myext_rshutdown_cleanup(void *dummy)函数执行释放逻辑。该方式能确保即使RSHUTDOWN主函数因异常跳过，资源仍会被清理。
【关键陷阱】不要在RSHUTDOWN中调用任何可能触发PHP用户代码的函数（如zend_call_method），PHP 8.4在此阶段已冻结执行栈，强行调用将导致SIGSEGV。
验证资源是否真正按请求隔离
编写测试脚本test.php：
<?php for ($i = 0; $i < 3; $i++) { echo "Request {$i}: ", myext_get_request_id(), "\n"; sleep(1); } ?>
在扩展中实现myext_get_request_id()函数，返回(uintptr_t)request_resource——每次请求输出的数值必须互不相同；若三次输出相同地址，说明RINIT未被触发或request_resource被声明为全局静态变量而未重置。
