PHP_MINIT阶段注册Swoole所有类（如Swoole\Server）到Zend引擎全局类表，通过zend_register_internal_class完成；PHP_FUNCTION宏展开后接收zval参数并用ZEND_PARSE_PARAMETERS_START解包；协程中static变量被共享，需用Co::getuid隔离状态；PHP_MSHUTDOWN不适用于清理协程资源，应交由onWorkerStop或PHP_RSHUTDOWN处理。
PHP扩展层与Zend引擎的交互不是“自动连通”，而是靠显式注册、zval解析和生命周期钩子三者协同；没搞清这三点，源码级问题一问就卡壳。
PHP_MINIT 里到底注册了什么
所有 Swoole 类（Swoole\Server、Swoole\Coroutine、Swoole\Http\Server）都在 PHP_MINIT 阶段通过 zend_register_internal_class 注入 Zend 引擎。这不是“声明类”，而是把 C++ 类结构体指针、方法表、属性表全塞进全局类表（CG(class_table)）。不走这步，PHP 脚本里 new 任何 Swoole 类都会报 Class 'Swoole\Server' not found。
常见错误现象：
- 编译完
swoole.so但php -m | grep swoole没输出 → 检查PHP_MINIT是否被调用（php_swoole.cc中的PHP_MINIT_FUNCTION(php_swoole)是否在zend_module_entry里注册） - 能加载扩展但
new Swoole\Server报错 → 看swoole_server.cc的PHP_MINIT(swoole_server)是否执行，以及zend_register_internal_class返回值是否为NULL
PHP_FUNCTION 宏展开后怎么处理 zval 参数
每个暴露给 PHP 的函数（比如 swoole_version）本质是 C 函数，接收 zend_execute_data * 和 zval *return_value。参数不是直接传 int 或 string，而是全部封装成 zval 数组，由 ZEND_PARSE_PARAMETERS_START 宏逐个解包。
关键点：
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
-
Z_PARAM_LONG解析整数时，实际读的是zval.value.lval，但前提是zval.u1.v.type是IS_LONG，否则会触发类型转换或报错 - 传数组或对象进来，
Z_PARAM_ARRAY或Z_PARAM_OBJ会拿到指针，但注意：它们只是引用，不是拷贝；修改内容会影响原始变量 - 返回字符串必须用
ZVAL_STRING(return_value, "xxx")，不能直接strcpy到某块栈内存——PHP 会接管这块内存的生命周期
协程函数里为什么不能直接用 static 变量
因为 PHP_RINIT 在 CLI 模式下只调一次，而协程是用户态调度，static $x 绑定的是当前 PHP 执行上下文（EG(current_execute_data)），不是协程栈。多个协程并发跑同一个函数时，static 变量会被所有协程共享，造成状态污染。
真实场景：
- 在
onRequest回调里写static $count = 0; $count++;→ 所有请求共用一个计数器，不是每请求独立 - 用
Co::create启动的协程中访问global $foo→$foo是 Worker 进程级全局，跨协程可见 - 正确做法：用
Co::getuid()做键，存到Swoole\Table或chan里隔离状态
PHP_MSHUTDOWN 为什么不能清理所有资源
PHP_MSHUTDOWN 是扩展卸载时调用，但它发生在进程退出前最后一刻，此时 Swoole 的 Reactor、Timer、Coroutine 调度器大多已 shutdown，强行调 swTimer_free() 或 swReactor_free() 可能触发空指针或 double-free。
更隐蔽的问题：
- 你在
PHP_MSHUTDOWN里unset了某个全局zval，但该zval还被某个未结束的协程栈帧引用 → 内存提前释放，后续协程恢复时 crash - Worker 进程因
max_request重启时，PHP_RSHUTDOWN会调，但PHP_MSHUTDOWN不会调 —— 所以依赖MSHUTDOWN做清理的逻辑，在常驻进程中根本不会执行 - 真正该清理的地方是
onWorkerStop回调，或在PHP_RSHUTDOWN中做轻量释放（如关闭文件描述符），重资源交给 Swoole 自身的 shutdown 流程
最易被忽略的一点：Zend 引擎的 zval 生命周期和 Swoole 协程生命周期是两套系统，混用 zval_ptr_dtor 和 Co::sleep 时，谁先谁后、谁持有引用，必须手动对齐；没人替你做 GC 插桩。
