必须精准控制PHP 8.0扩展在模块初始化、请求处理、脚本执行、请求关闭、模块卸载五阶段的行为，任一钩子注册错误或返回值异常均会导致崩溃或内存泄漏。
要在PHP 8.0中开发可稳定运行的扩展，必须精准控制其在模块初始化、请求处理、脚本执行、请求关闭、模块卸载这五个关键阶段的行为——任何一个钩子函数注册错误或返回值不符合预期，都会导致扩展崩溃或内存泄漏。
理解PHP 8.0扩展的五大生命周期阶段
PHP 8.0沿用但强化了经典的五阶段模型：php_module_startup → php_request_startup → php_execute_script → php_request_shutdown → php_module_shutdown。这并非线性流程，而是嵌套结构：一次CLI执行只触发模块级钩子各一次，但一个FPM进程可能处理数百个请求，每个请求都完整走一遍请求级钩子。
模块级钩子（MINIT/MSHUTDOWN）在SAPI启动和退出时调用，全局仅一次；请求级钩子（RINIT/RSHUTDOWN）每次HTTP请求或CLI命令执行时都触发，且【RINIT中分配的资源必须在RSHUTDOWN中显式释放，否则将累积造成内存泄漏】。
PHP 8.0新增了ZEND_INIT_MODULE宏用于模块入口校验，若未正确定义zend_module_entry中的module_startup_func字段，扩展加载时会直接报错“Unable to start builtin modules”，不进入任何钩子流程。
立即学习“PHP免费学习笔记（深入）”；
注册MINIT与MSHUTDOWN钩子
方法一：在zend_module_entry结构体中直接赋值
找到扩展源码中的myext_module_entry定义，在其字段列表里明确写入：.module_startup_func = myext_module_init,.module_shutdown_func = myext_module_shutdown。这两个函数必须声明为int类型，且【返回FAILURE会导致整个PHP进程拒绝加载该扩展，不可逆】。
方法二：使用ZEND_MINIT_FUNCTION和ZEND_MSHUTDOWN_FUNCTION宏封装
在.c文件中写ZEND_MINIT_FUNCTION(myext) { /* 初始化全局变量、注册常量、加载INI配置 */ return SUCCESS; }，然后在module_entry中填.module_startup_func = ZEND_FN(myext)。宏封装自动处理参数签名，避免手动写错zval**类型的参数导致段错误。
实现RINIT与RSHUTDOWN的正确姿势
第一步：在RINIT中初始化请求独占资源
例如分配一个zend_string缓存区、初始化EG(current_execute_data)相关状态、重置自定义全局计数器。注意不要在此处malloc大块内存——PHP 8.0已废弃emalloc以外的内存分配方式，直接调用libc malloc会绕过GC管理。
第二步：确保RSHUTDOWN严格配对释放
若RINIT中调用zend_string_init_ex创建了字符串，RSHUTDOWN中必须调用zend_string_release；若RINIT中调用ALLOC_HASHTABLE初始化了哈希表，RSHUTDOWN中必须调用zend_hash_destroy + FREE_HASHTABLE。漏掉任意一项，下次请求复用该内存时会触发UAF（Use-After-Free）。
第三步：禁止在RSHUTDOWN中调用PHP用户函数
此时EG(function_table)可能已被清空，call_user_function会直接abort。只能操作C层数据结构或调用ZEND_API内部函数。
在php_execute_script阶段注入逻辑
这个阶段没有独立钩子，但可通过注册opcache优化回调或修改编译后的op_array实现干预。最常用的是在compile_file钩子中拦截.php文件加载：在MINIT中调用zend_register_extension并设置->compile_file成员为自定义函数。该函数接收zend_file_handle*参数，可读取原始内容做AST分析或动态注入代码。
注意：PHP 8.0默认启用Opcache，若未在php.ini中设置opcache.enable_cli=1（CLI模式）或opcache.enable=0（调试时），你的compile_file回调可能被跳过——因为Opcache已从共享内存返回缓存字节码，根本不调用编译流程。
调试钩子是否生效的三步验证法
① 在每个钩子函数开头插入fprintf(stderr, "[MINIT] %s\n", __func__); fflush(stderr); 然后用strace -e trace=write ./php -m 2>&1 | grep MINIT确认输出。
② 使用GDB在php_module_startup函数下断点，运行bt查看调用栈是否出现你的扩展名。若没出现，说明module_entry未正确注册进extension_list链表。
③ 在RINIT中故意返回FAILURE，观察PHP是否报“Failed to initialize script engine”并退出——这是验证钩子已挂载的最快方式。
