编写PHP扩展实战：从零使用ext_skel搭建C语言扩展

Chloe

发布时间：2026-10-14| 2人浏览过

原创

当PHP原生功能无法满足性能要求或需调用底层系统接口时，编写PHP扩展是提升效率的关键手段。尽管开发门槛高于纯PHP脚本，但通过官方提供的ext_skel框架，可以大幅降低入门难度。本文将演示如何基于C/C++创建一个基础的"Hello World"扩展，完成代码生成、编译安装及生效验证。

使用 ext_skel 生成扩展骨架

编写PHP扩展通常需要先准备好PHP源码或开发包。在PHP源码目录的ext路径下，存在一个名为ext_skel的辅助脚本，它能自动生成为运行扩展所必需的基础文件结构。无需手动创建繁杂的Makefile或配置文件，该工具提供了标准化的起点。

第1步：初始化扩展目录结构

目的：获取包含头文件、源文件和配置模板的最小化项目。

入口：终端命令行，确保当前位于PHP源码的ext目录下。
动作：执行以下命令，将生成一个名为myext的子目录及其内部结构：

./ext_skel --extname=myext

第2步：配置依赖与开关

目的：告诉构建系统在编译时是否链接外部库，以及用户如何通过configure参数启用扩展。

入口：打开新创建的/myext/config.m4文件。
动作：根据是否需要依赖第三方C库（如OpenSSL、cURL等），选择并取消注释相应宏。若扩展仅依赖标准PHP环境，可使用以下任意一种方式：

方案A：不依赖外部库（推荐初学者）

dnl PHP_ARG_ENABLE(myext, whether to enable myext support,
dnl Make sure that the comment is aligned:
dnl [ --enable-myext Enable myext support])
// 移除前面的dnl注释符
PHP_ARG_ENABLE(myext, whether to enable myext support,
Make sure that the comment is aligned:
[ --enable-myext Enable myext support])

方案B：依赖外部库

dnl PHP_ARG_WITH(myext, for myext support,
dnl Make sure that the comment is aligned:
dnl [ --with-myext Include myext support])
// 移除前面的dnl注释符
PHP_ARG_WITH(myext, for myext support,
Make sure that the comment is aligned:
[ --with-myext Include myext support])

第3步：定义PHP可调用的函数

目的：将C语言的函数映射为PHP环境中可执行的函数名。

入口：myext/php_myext.h和myext/myext.c。
动作：

声明函数：在php_myext.h中，找到测试函数声明行，将其替换或添加为自定义函数的声明：

PHP_FUNCTION(myext); /* For testing, remove later. */

注册函数：在myext.c中找到函数入口数组myext_functions[]，将占位符替换为实际函数名：

zend_function_entry myext_functions[] = {
 PHP_FE(myext, NULL) /* For testing, remove later. */
 {NULL, NULL, NULL} /* Must be the last line in myext_functions[] */
};

实现逻辑：在myext.c文件末尾添加具体的C语言函数实现。此处以输出信息为例：

PHP_FUNCTION(myext)
{
 zend_printf("Hello World!\n");
}

第4步：编译与安装扩展

目的：将源代码转化为操作系统识别的动态链接库文件（.so）。

入口：进入扩展根目录cd /path/to/myext。
动作：依次执行以下命令链。注意替换为你实际的PHP安装路径：

# 1. 生成 configure 脚本
/usr/local/php/bin/phpize

# 2. 配置编译环境
./configure --with-php-config=/usr/local/php/bin/php-config

# 3. 编译对象文件
make

# 4. 安装扩展文件到指定目录
make install

执行成功后，终端通常会提示.so文件已生成的具体路径，记下此路径以便后续配置。

激活扩展并验证结果

最后一步是将扩展加载到PHP运行时环境中。

第5步：修改 php.ini 配置

入口：PHP配置文件php.ini。
动作：在文件中添加一行配置，指向刚才编译安装的扩展路径。例如：

extension = "myext.so"

第6步：重启服务并检测

入口：Web服务器（如Apache/Nginx+PHP-FPM）或CLI环境。
动作：重启Web服务器使配置生效。随后创建一个PHP测试文件test.php：

<?php
myext();
?

运行该脚本，若控制台或浏览器无报错且能正常响应，说明扩展已成功载入。为了更直观地查看扩展是否被正确识别，也可以访问phpinfo()页面，搜索myext关键词。

通过上述流程，我们成功构建了一个基于C/C++的PHP扩展。虽然对于简单的"Hello World"而言，直接使用PHP可能更高效，但在处理高并发计算、复杂数据结构或与底层硬件交互时，这种模式能显著降低脚本复杂度并大幅提升执行效率。唯一需要注意的是，C语言扩展一旦上线，任何逻辑变更都需要经历“修改源码-重新编译-重载服务”的周期，因此在需求频繁变动的阶段需谨慎使用。

以上就是如何编写PHP扩展并使用ext_skel进行开发的详细内容，更多关于PHP底层机制优化的资料请关注本站其它相关文章！