必须卸载系统php-dev包，改用PHP 8.3源码自带的phpize和php-config；检查Zend头文件是否存在；用ext_skel生成骨架或手动创建config.m4、php_stringproc.h、stringproc.c；配置时指定正确php-config路径，编译后复制.so到扩展目录并启用。
想为PHP 8.3写一个能提升字符串处理性能的扩展，却卡在环境配不起来、phpize报错、编译后extension_dir找不到so文件——这不是你代码写得不对，而是开发环境根本没对齐Zend API版本、缺少头文件或php-config路径错位。
确认开发环境是否就绪
第一步：运行验证脚本检查基础组件是否齐全。打开终端，粘贴并执行以下命令：
php -v | grep "8\.3" && phpize -v | grep "8\.3" && which php-config
若输出中缺失phpize版本号、或php-config路径指向/usr/bin/php-config（而非PHP 8.3安装目录下的同名文件），说明你正在用系统旧版PHP工具链——这会导致后续所有编译失败，【必须卸载系统php-dev包，改用PHP 8.3源码自带的phpize和php-config】。
立即学习“PHP免费学习笔记（深入）”；
第二步：检查PHP开发头文件是否存在。执行：ls /usr/include/php/Zend/zend.h 2>/dev/null || echo "❌ 缺失Zend头文件"。Windows用户请确认已安装php-dev或从php.net下载完整ZIP包并解压出include目录；macOS用户需运行brew install php@8.3而非仅brew install php，否则头文件路径不匹配。
创建扩展骨架并初始化
方法一：用ext_skel快速生成（推荐新手）
进入PHP源码目录下的ext子目录（如~/php-8.3.10/ext），执行：./ext_skel --extname=stringproc。这会自动生成stringproc文件夹，含config.m4、php_stringproc.h、stringproc.c等核心文件。
方法二：手动创建最小结构（适合理解原理）
新建目录~/myext/stringproc，在其中创建三个必需文件：config.m4（声明扩展名与依赖）、php_stringproc.h（头文件包含宏定义）、stringproc.c（主实现文件）。注意config.m4里必须写PHP_NEW_EXTENSION(stringproc, stringproc.c, $ext_shared)，漏掉$ext_shared会导致静态编译，无法生成.so文件。
配置、编译并加载扩展
① 进入扩展目录：cd ~/myext/stringproc
② 执行phpize（确保是PHP 8.3安装路径下的版本，可用which phpize确认）→ 运行./configure --with-php-config=/usr/local/php-8.3.10/bin/php-config（路径必须与which php-config输出一致，Mac Apple Silicon用户路径通常是/opt/homebrew/bin/php-config）→ 执行make。
③ 编译成功后，.libs/stringproc.so即为目标文件。把它复制到PHP扩展目录：cp .libs/stringproc.so $(php --ini | grep "Scan for additional .ini files" | cut -d':' -f2 | xargs)/stringproc.ini，然后在该.ini文件中写入extension=stringproc。
④ 重启PHP服务（CLI模式直接生效，Web服务器需重启Apache/Nginx）→ 运行php -m | grep stringproc，看到输出即表示加载成功。
编写第一个函数：str_reverse()
打开stringproc.c，在ZEND_BEGIN_ARG_INFO_EX之后、PHP_FE_END之前插入函数定义：
ZEND_FUNCTION(str_reverse) { zend_string *input; if (zend_parse_parameters(ZEND_NUM_ARGS(), "S", &input) == FAILURE) { RETURN_FALSE; } char *rev = emalloc(ZSTR_LEN(input) + 1); for (size_t i = 0; i
这段代码用C语言实现字符串反转，关键点在于：必须用emalloc/ efree而非malloc/ free——PHP内存管理器需要接管分配的内存，否则可能触发段错误；zend_parse_parameters的"S"类型标识专用于zend_string*，比旧版"s"更安全，避免长度截断。
保存后重新make clean && make，再运行php -r "echo str_reverse('hello');"，输出olleh即完成首个函数开发。
