phpize编译失败主因是缺失autoconf等构建工具或php-config路径错误，需安装对应系统开发包（如php-dev/php-devel）、用绝对路径指定php-config，并确保PHP版本一致。
phpize 编译失败：找不到 php-config 或 autoconf 报错
常见现象是执行 phpize 后提示 Cannot find config.m4，或 configure: error: Cannot find php-config。根本原因是 PHP 开发头文件和构建工具链不完整，不是“没装 phpize”这么简单。
必须确认三件事：
- 已安装对应 PHP 版本的
php-dev（Debian/Ubuntu）或php-devel（RHEL/CentOS/Fedora）包，而非仅运行时 php 包 -
php-config命令存在且路径正确，可通过which php-config和php-config --version验证版本是否匹配你正在编译的扩展目标 PHP 版本 - 当前 shell 环境中
PATH包含php-config所在目录；若用多版本 PHP（如 via asdf、phpenv），需先phpenv local 8.7再运行phpize
如果仍报 autoconf 相关错误（如 aclocal: command not found），说明 GNU Build System 缺失：Debian/Ubuntu 装 autoconf automake libtool，macOS 用 brew install autoconf automake libtool。
zend_parse_parameters 参数解析失败：类型不匹配或内存越界
写完 C 函数后，PHP 调用时报 Warning: Wrong parameter count or type 或直接 segfault，90% 是 zend_parse_parameters() 的格式字符串和参数地址没对齐。
关键点：
- 格式符必须严格匹配传入值：比如 PHP 传整数，C 里用
long *接收（PHP 8+ 统一为zend_long），不能用int *—— 否则在 64 位系统上读错内存 - 字符串参数必须同时传
char **和size_t *（即&str, &str_len），漏掉str_len会导致后续memcpy越界 - 可选参数要用
|分隔，且所有可选参数变量必须初始化（如zend_long n = 1;），否则未传参时该变量值是栈垃圾 - 不要在
zend_parse_parameters()后直接RETURN_STRINGL(result, len, 0)—— 若result是emalloc分配的，必须用efree()清理，否则内存泄漏
FFI vs 原生扩展：什么时候不该写 .so
不是所有“要调 C”的场景都该立刻开 ext 目录写扩展。FFI 在 PHP 7.4+ 已稳定，对多数集成需求更轻量。
选 FFI 更合适的情况：
- 只调用现成的系统库（如
libc.so.6、libcurl.so）或第三方.so，无源码修改需求 - 开发周期短、部署环境受限（如共享主机无法改
php.ini加载扩展） - 函数调用频次不高（
必须写原生扩展的硬性条件：
- 需要访问 Zend 引擎内部结构（如操作
zval、注册自定义资源、挂钩 RINIT/RSHUTDOWN） - 高频调用（>1k 次/秒）且对延迟敏感（FFI 每次调用有额外 ABI 封装开销）
- 需长期持有 C 层状态（如连接池、缓存句柄），而 FFI 不支持跨调用保存指针
扩展加载后函数不存在：config.m4 或 MINIT 阶段遗漏
编译成功、extension=my_ext.so 已写入 php.ini、重启 PHP-FPM 后，function_exists('my_ext_do') 仍返回 false。
排查顺序：
- 检查
config.m4是否启用模块：确认有PHP_ARG_ENABLE(my_ext, ...)且未被dnl注释，否则./configure会跳过注册 - 确认
my_ext.c中PHP_FE宏已将函数加入my_ext_functions[]表，并以{NULL, NULL, NULL}结尾 - 确保
PHP_MINIT_FUNCTION(my_ext)内调用了register_functions(my_ext_functions)；PHP 8.0+ 还需检查是否误删了ZEND_MODULE_STARTUP_D(my_ext)宏 - 用
php -m | grep my_ext看扩展名是否列出；若没出现，说明php.ini加载路径不对或扩展文件权限为 0600（PHP 会静默跳过）
最易忽略的是：PHP CLI 和 Web SAPI（如 php-fpm）可能加载不同配置文件，php --ini 和 phpinfo() 输出的 Loaded Configuration File 必须一致。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
