照着走一遍，你就能从零编译出一个能被 php -m 认出来的 C 语言扩展，并知道每个文件、每条命令到底在干什么。
第一步：装齐工具链
扩展开发需要编译器 + PHP 的开发头文件 + 构建脚本工具：
apt install php-dev gcc make autoconf
# CentOS / Rocky（以 PHP 8.2 为例）
yum install php-devel gcc make autoconf
装完先确认两件事：
php -v # 运行时版本，比如 8.2.15
php-config --version # 开发包版本，必须和上面一致
php-config --extension-dir # .so 最终要落到的目录
注意：phpize 的版本和实际运行 PHP 的版本必须严格一致。版本对不上，编译能过、加载必挂。宝塔面板装的 PHP，用 /www/server/php/82/bin/phpize 这种绝对路径，别用系统的。
第二步：生成扩展骨架
PHP 自带一个生成器 ext_skel.php，它躺在 PHP 源码包的 ext/ 目录里。
- 如果有源码包：
cd php-src/ext && php ext_skel.php --ext=hello
- 发行版的
php-dev 包常常不带这个文件，那就去 php.net 下对应版本的源码包，解压后只取 ext/ext_skel.php 用，不需要编译整个 PHP。
执行后会得到 hello/ 目录，里面最该关注三个文件：
config.m4 —— 告诉构建系统怎么编译php_hello.h —— 头文件，声明函数hello.c —— 真正的实现
注意：骨架只是省事，不是必需。手写这三个文件同样能编译，理解结构比会用生成器重要。
第三步：看懂 config.m4
打开 config.m4，核心是这段：
PHP_ARG_ENABLE([hello],
[whether to enable hello support],
[AS_HELP_STRING([--enable-hello], [Enable hello support])],
[no])
if test "$PHP_HELLO" != "no"; then
PHP_NEW_EXTENSION(hello, hello.c, $ext_shared)
fi
意思很直白：./configure 时传 --enable-hello 才编译，源码文件是 hello.c。如果以后拆成多个 .c 文件，在这里用空格隔开列全即可。
第四步：在 hello.c 里写函数
把 hello.c 里自带的一堆示例函数删掉，只留模块入口，然后加入自己的函数：
ZEND_BEGIN_ARG_INFO_EX(arginfo_hello_greet, 0, 0, 1)
ZEND_ARG_INFO(0, name)
ZEND_END_ARG_INFO()
PHP_FUNCTION(hello_greet)
{
char *name;
size_t name_len;
ZEND_PARSE_PARAMETERS_START(1, 1)
Z_PARAM_STRING(name, name_len)
ZEND_PARSE_PARAMETERS_END();
RETURN_STR(strpprintf(0, "Hello, %s!", name));
}
static const zend_function_entry hello_functions[] = {
PHP_FE(hello_greet, arginfo_hello_greet)
PHP_FE_END
};
模块入口结构体里，hello_functions 就是函数注册表，PHP 侧能调到哪些函数全看它。
注意：C 扩展里不要用 malloc / free，要用 emalloc / efree；字符串用 zend_string。用错分配器会导致请求结束时内存统计错乱甚至崩溃。另外，绝不能返回函数内局部数组的指针，必须用 RETURN_STR 这类宏让引擎接管生命周期。
第五步：编译安装
cd hello
phpize
./configure --with-php-config=$(which php-config)
make
sudo make install
make install 会把 hello.so 拷到 php-config --extension-dir 显示的目录。
注意：非 root 环境或宝塔环境可能拷不进去，那就手动把 modules/hello.so 复制过去。改了 C 代码后必须重新 make && make install，重启 PHP 才会生效。
第六步：启用并验证
在 php.ini 末尾加一行：
extension=hello.so
重启 PHP（systemctl restart php-fpm 或面板里重载），然后验证：
php -m | grep hello
php -r 'echo hello_greet("world"), PHP_EOL;'
看到 hello 出现在模块列表、命令行输出 Hello, world!，第一个扩展就跑通了。
注意：如果 php -m 里没有，先看 php -i | grep extension_dir 确认路径，再用 php -d extension=hello.so -v 单独加载，报错信息会直接告诉你符号缺失还是版本不符。
小结
- 工具链核心是
php-devel + phpize，版本必须和运行环境一致
config.m4 决定编译方式，zend_function_entry 决定对外暴露哪些函数- 参数解析用
Z_PARAM_* 宏，返回字符串用 RETURN_STR，内存一律走 emalloc 系
- 流程固定：
phpize → configure → make → make install → 改 php.ini → 重启
- 每改一次代码都要重编译并重启，扩展改动不会热生效
正式会员
认证极客
钻石卡会员
见习用户
