PHP自定义扩展需五步：一、安装php-dev等开发包并确认phpize可用；二、用ext_skel生成骨架；三、修改config.m4、php_myext.h和myext.c实现函数；四、phpize后configure、make install编译安装；五、php.ini中启用并验证。
如果您希望为PHP添加特定功能，但现有扩展无法满足需求，则需要编写自定义扩展。以下是PHP自定义扩展入门的基础步骤：
一、准备开发环境与工具链
编写PHP扩展依赖C语言编译工具和PHP源码支持文件，需确保系统中已安装PHP开发包及构建工具，以便生成可加载的动态模块。
1、安装PHP开发包：在Ubuntu系统中执行 sudo apt install php-dev；在CentOS/RHEL中执行 sudo yum install php-devel 或 sudo dnf install php-devel。
2、确认phpize命令可用：运行 phpize --version，输出版本号表示环境就绪。
立即学习“PHP免费学习笔记（深入）”；
3、获取当前PHP源码路径：执行 php-config --extension-dir 和 php-config --include-dir，用于后续编译时引用头文件。
二、使用ext_skel生成扩展骨架
PHP官方提供ext_skel脚本，可快速生成符合规范的扩展目录结构和基础代码文件，避免手动创建错误的入口函数或配置模板。
1、进入PHP源码的ext目录：执行 cd /path/to/php-source/ext（路径可通过 php-config --configure-options | grep "--srcdir" 获取）。
2、运行骨架生成命令：执行 ./ext_skel --extname=myext，其中myext为扩展名称，将生成myext子目录及config.m4、php_myext.h、myext.c等文件。
3、切换至新扩展目录：执行 cd myext，确认php_myext.h和myext.c已存在。
三、修改配置与实现基础函数
config.m4文件控制扩展的编译选项，php_myext.h声明扩展接口，myext.c实现具体逻辑；三者需同步调整以保证编译通过并导出预期函数。
1、编辑config.m4：取消注释 PHP_ARG_ENABLE(myext, whether to enable myext support) 行，并将 [ --enable-myext 改为 [ --enable-myext=shared 以支持动态加载。
2、在php_myext.h中添加函数声明：在PHP_FUNCTION段落内插入 PHP_FUNCTION(myext_hello);。
3、在myext.c中实现函数体：在PHP_FE_END上方添加 PHP_FE(myext_hello, NULL)，并在文件末尾补充函数定义，内容为 RETURN_STRING("Hello from myext!");。
四、编译并安装扩展
通过phpize生成configure脚本，再经make完成编译，最终将生成的so文件复制到PHP扩展目录并注册启用。
1、在扩展根目录执行 phpize，生成configure脚本。
2、运行 ./configure --enable-myext，指定启用该扩展。
3、执行 make && sudo make install，编译完成后.so文件路径将显示在终端，如 /usr/lib/php/20220829/myext.so。
五、启用扩展并验证
PHP需明确加载新扩展才能调用其函数，通过修改php.ini或使用ini配置片段启用，并通过命令行验证是否识别成功。
1、查找php.ini路径：运行 php --ini | grep "Loaded Configuration File"。
2、在php.ini末尾添加： extension=myext.so（若为绝对路径则写完整路径）。
3、执行 php -m | grep myext，若输出myext则表示加载成功；再运行 php -r "echo myext_hello();" 应输出 Hello from myext!。
