必须使用php 8.4源码树及对应ext_skel生成扩展骨架，否则因zend_module_api_no不一致报错；需安装php-dev/php-devel等依赖，正确配置config.m4并用--enable-myhello=shared编译，最后通过extension=myhello.so启用。
要在Linux上为PHP 8.4开发并编译自定义扩展，必须使用与目标PHP版本完全匹配的源码树、正确的构建工具链，且不能复用PHP 8.3或更早版本的ext_skel脚本生成结构——否则在configure阶段就会因ZEND_MODULE_API_NO不一致而报错。
准备PHP 8.4源码与开发环境
进入临时工作目录：cd /tmp && mkdir php84-ext-dev && cd php84-ext-dev
下载PHP 8.4.14正式版源码（截至2026年8月，这是最新GA版本）：wget https://www.php.net/distributions/php-8.4.14.tar.gz && tar -zxvf php-8.4.14.tar.gz
安装编译依赖：Ubuntu/Debian执行sudo apt install build-essential autoconf automake libtool pkg-config php-dev libxml2-dev libsqlite3-dev libonig-dev libzip-dev；Rocky/Kylin系执行sudo dnf groupinstall "Development Tools" && sudo dnf install php-devel libxml2-devel sqlite-devel oniguruma-devel libzip-devel。注意：php-dev（Debian）或 php-devel（RHEL系）是强制前提，缺它无法生成正确config.m4。
进入PHP源码根目录：cd php-8.4.14。这一步不可跳过，因为ext_skel必须在源码树内运行才能读取正确的Zend头文件路径和API宏定义。
用ext_skel生成扩展骨架
方法一：标准流程（推荐）
执行./buildconf --force确保autoconf脚本就绪，再运行./ext/ext_skel --extname=myhello。该命令会自动创建ext/myhello/目录及全套文件：config.m4、php_myhello.h、myhello.c。
方法二：跳过buildconf（仅限已执行过一次的源码树）
直接cd ext && ./ext_skel --extname=myhello。若提示“command not found”，说明buildconf未运行，必须退回上层目录补做。
⚠️ 注意：不要手动复制旧版本扩展目录来改名，PHP 8.4中zend_module_entry结构体字段已增加min_php_version和globals_size等新成员，硬改会导致编译失败或运行时段错误。
修改核心代码并配置编译选项
第一步：编辑ext/myhello/myhello.c，将PHP_FUNCTION(confirm_myhello_compiled)函数体替换为：RETURN_STRING("Hello from PHP 8.4 extension!");。这行代码调用的是PHP 8.4新增的RETURN_STRING宏，它内部自动处理了ZVAL的GC引用计数，比旧版RETVAL_STRING更安全。
第二步：编辑ext/myhello/config.m4，取消注释PHP_ARG_ENABLE(myhello, whether to enable myhello support,这一整段，并确认其中if test "$PHP_MYHELLO" != "no"; then分支下的PHP_NEW_EXTENSION(myhello, myhello.c, $ext_shared)未被注释——这是注册扩展到构建系统的唯一入口。
第三步：回到PHP源码根目录，执行./configure --disable-all --enable-cli --enable-myhello=shared --with-pic。这里--disable-all是关键，避免加载其他扩展干扰链接；--enable-myhello=shared告诉configure把myhello编译为动态模块；--with-pic确保生成位置无关代码，否则在某些发行版（如Kylin V10SP3）上load时会报“cannot load shared object”的错误。
编译安装并启用扩展
执行make -j$(nproc)开始编译。若中途报错“undefined reference to `php_output_write'”，说明漏装libxml2-dev或php-dev，需中断后补依赖再重来。
编译成功后执行sudo make install，输出中应包含Installing shared extensions: /usr/lib/php/20240829/（路径中的20240829是PHP 8.4的Zend API编号，不可更改）。
查找PHP配置目录：php --ini | grep "Loaded Configuration File"，然后在对应php.ini末尾添加：extension=myhello.so。注意不要写成extension=/usr/lib/php/20240829/myhello.so——绝对路径会导致PHP启动时拒绝加载。
验证是否生效：php -m | grep myhello，有输出即表示扩展已载入；再执行php -r "echo myhello();"，终端打印Hello from PHP 8.4 extension!即完成全流程。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
