PHP 8.7扩展开发必须严格对齐源码、工具链与版本声明：需在zend_module_entry中显式填写"8.7.0"，不可省略STANDARD_MODULE_HEADER_EX宏，内存释放改用pefree_safe()，并确保使用PHP 8.7源码编译，否则zval偏移错乱致运行时随机崩溃。
PHP扩展开发不是“学完就能用”，而是“配错环境就卡死”。2026年真实开发中，90%的失败发生在phpize阶段或make报错，根源不是C语言写得不对，而是PHP源码、构建工具链、版本声明三者没对齐。
确认你真在用 PHP 8.7+ 的扩展架构
PHP 8.7 强制要求扩展声明最低兼容版本，否则zend_module_entry加载直接失败，错误不提示具体原因，只报PHP Warning: Module 'xxx' already loaded in Unknown on line 0这类误导信息。
- 必须在
myext.c里显式填入"8.7.0"（不能写"8.7"或留空） -
STANDARD_MODULE_HEADER_EX宏已不可省略，漏写会导致sizeof(zend_module_entry)计算错误 - 所有内存释放必须改用
pefree_safe()，旧版efree()在多线程下会触发double free
phpenv + php-build 编译扩展前必做的三件事
用phpenv管理多版本PHP时，扩展编译极易因路径错位失败。不是phpenv install装得不对，而是扩展找不到它该链接的PHP头文件。
- 执行
phpenv global 8.7.2后，立刻运行phpenv rehash，否则phpize仍调用旧版本 - 确保
php-config --include-dir输出路径存在且可读，常见问题：路径含空格或符号链接断裂 - 编译前手动检查
ls $(php-config --include-dir)/main能否列出php.h，缺这个文件make必然失败
config.m4 里最容易漏掉的两行依赖
扩展若调用OpenSSL、cURL或PCRE等系统库，config.m4里光写PHP_CHECK_LIBRARY不够，必须补全头文件检测和链接标志。
立即学习“PHP免费学习笔记（深入）”；
- 检测头文件：
PHP_CHECK_HEADER(openssl/ssl.h, , [AC_MSG_ERROR(openssl/ssl.h not found)]) - 追加链接参数：
PHP_ADD_LIBRARY_WITH_PATH(ssl, /usr/lib, MYEXT_SHARED_LIBADD)（路径需按实际调整） - 漏掉任一环节，
./configure成功但make报undefined reference to SSL_new
调试时别信php -m的输出
php -m只显示ini中启用的扩展，不验证是否真正加载成功。很多扩展看似列出来了，但调用函数时抛Call to undefined function。
- 用
php --ri myext查看真实加载状态，有输出才代表Zend模块注册成功 - 若
--ri无响应，说明PHP_MINIT函数未被调用，大概率是zend_module_entry结构体字段顺序错或PHP_FE_END缺失 - 日志里搜
[pool www] child 1234 exited on signal Segmentation fault，基本是ZEND_PARSE_PARAMETERS_START参数解析失败导致的段错误
最常被忽略的是：PHP 8.7 扩展必须用对应版本的php-src源码编译，混用 8.6 的源码和 8.7 的二进制会导致zval结构体偏移错乱——这种错误不会在编译时报出，而是在首次调用函数时随机崩溃。
