PHP源码项目：如何创建独立PHP扩展教程
【免费下载链接】php-src The PHP Interpreter 
项目地址: https://gitcode.com/GitHub_Trending/ph/php-src
前言
在PHP开发中，扩展是增强PHP功能的重要方式。本文将详细介绍如何在PHP源码项目(php/php-src)中创建独立的自包含PHP扩展，这种扩展可以脱离PHP源码树独立分发和使用。
什么是自包含PHP扩展
自包含PHP扩展是指不依赖于PHP源码树，可以独立编译、安装和分发的PHP扩展。它具有以下特点：
- 包含完整的配置和源代码
- 不需要修改PHP核心代码
- 可以单独打包分发
准备工作
在开始创建扩展前，需要确保开发环境中安装了以下工具：
- GNU autoconf：用于生成配置脚本
- GNU libtool：管理库编译过程
- GNU m4：宏处理器，autoconf的依赖
创建自包含扩展的基本步骤
1. 准备扩展目录结构
首先创建一个空目录作为扩展的工作目录：
mkdir my_extension
cd my_extension
2. 编写配置文件(config.m4)
config.m4是扩展的构建配置文件，使用m4宏语言编写。下面是一个基本模板：
PHP_ARG_ENABLE([myext],
[whether to enable myext support],
[AS_HELP_STRING([--enable-myext],
[Enable myext support])])
if test "$PHP_MYEXT" != "no"; then
PHP_NEW_EXTENSION([myext], [myext.c], [$ext_shared])
fi
这个文件主要做了三件事：
- 定义配置选项(--enable-myext)
- 检查用户是否启用了该扩展
- 如果启用，则调用PHP_NEW_EXTENSION宏注册扩展
3. 编写扩展源代码
扩展通常由一个或多个C源文件组成。基本结构包括：
- 模块入口定义
- 函数实现
- 模块信息声明
可以使用PHP提供的ext_skel.php工具生成基本骨架代码：
php ext_skel.php --extname=myext
4. 关键宏和函数
在扩展代码中，有几个关键部分需要注意：
// 模块入口声明
zend_module_entry myext_module_entry = {
STANDARD_MODULE_HEADER,
"myext", // 扩展名称
myext_functions, // 函数列表
PHP_MINIT(myext), // 模块初始化函数
NULL, // 模块关闭函数
NULL, // 请求初始化函数
NULL, // 请求关闭函数
PHP_MINFO(myext), // 模块信息函数
PHP_MYEXT_VERSION, // 版本号
STANDARD_MODULE_PROPERTIES
};
// 动态加载支持
#ifdef COMPILE_DL_MYEXT
ZEND_GET_MODULE(myext)
#endif
5. 构建扩展
准备好配置和源代码后，使用phpize工具生成构建系统：
phpize
./configure
make
phpize会完成以下工作：
- 生成configure脚本
- 准备Makefile.in模板
- 设置PHP构建环境
6. 安装扩展
构建完成后，可以安装扩展：
make install
安装后需要在php.ini中添加：
extension=myext.so
实际案例：转换现有扩展
假设我们要将PHP源码中的某个扩展(如mysqli)转换为自包含扩展：
- 创建新目录并复制文件：
mkdir /tmp/mysqli_ext
cp -r php-src/ext/mysqli/* /tmp/mysqli_ext/
- 进入目录并运行phpize：
cd /tmp/mysqli_ext
phpize
- 配置和编译：
./configure --with-php-config=/path/to/php-config
make
现在这个mysqli扩展就可以独立分发了。
高级主题：共享模块支持
要使扩展可以作为共享模块(.so文件)加载，需要：
- 在config.m4中使用$ext_shared变量：
PHP_NEW_EXTENSION([myext], [myext.c], [$ext_shared])
- 在源代码中添加动态加载支持：
#ifdef COMPILE_DL_MYEXT
ZEND_GET_MODULE(myext)
#endif
最佳实践
- 版本定义：在头文件中定义扩展版本
#define PHP_MYEXT_VERSION "1.0.0"
-
许可证文件：包含LICENSE或COPYING文件
-
清晰的文档：提供安装和使用说明
-
测试用例：包含测试脚本确保功能正常
常见问题解决
- phpize找不到：确保PHP开发包已安装，或指定完整路径：
/path/to/php/bin/phpize
-
头文件找不到：检查PHP安装路径，确保php-config路径正确
-
符号未定义：检查是否正确定义了所有必要的Zend宏和函数
总结
创建自包含PHP扩展是一个系统化的过程，需要：
- 准备正确的构建环境
- 编写合适的config.m4配置文件
- 实现扩展功能代码
- 使用phpize生成构建系统
- 编译和安装扩展
通过本文介绍的方法，开发者可以创建独立于PHP源码树的扩展，便于分发和维护。这种扩展开发模式是PHP生态系统中模块化开发的重要方式。
【免费下载链接】php-src The PHP Interpreter 项目地址: https://gitcode.com/GitHub_Trending/ph/php-src
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
