PHP扩展开发
我准备在此系列博文中总结我有关PHP扩展开发的学习和感悟,力图简单清晰地描述在Linux系统下开发一个PHP扩展应该具备的最基本知识。水平较低,难免有错误,望指出。
准备工作
首先要获取一份PHP源码(可以从Github上签出,或者到官网上下载最新的稳定版),然后编译之。为了加快编译速度,我们推荐禁用所有额外的扩展(使用--disable-all选项),但最好打开debug(使用--enable-debug选项)和线程安全(使用--enable-maintainer-zts),但要在发布扩展的时候关闭debug,视情况选择是否需要打开线程安全:
编译后的PHP的可执行程序在源码的sapi目录下,对应不同的宿主环境有不同的子目录,我们以后都主要使用cli(command line interface)环境,可以建一个别名方便引用:
有一些命令行选项是很有用的:
# 执行code里的代码
扩展骨架
PHP的所有官方扩展都在源码的ext目录下,我们自己写的扩展也可以放在该目录下。注意,该目录下有个名为ext_skel的shell脚本,它是用来生成PHP扩展骨架的,使用该脚本,可以帮我们快速创建PHP扩展:
接下来让我们完成我们的扩展。进入myext目录,编辑config.m4配置文件,找到PHP_ARG_ENABLE宏函数,去掉前面的dnl注释(共三行)。退回到源码根目录,重新执行buildconf、configure和make命令:
注意,我们用./configure --help | grep myext打印了我们扩展的加载情况,如果看不到下面的输出,则说明我们的扩展没有配置成功,回头检查下config.m4文件。
这次编译应该非常快,因为大部分代码都已经编译过了。PHP还有另外一种编译扩展的方法(使用动态连接的方式,将扩展编译为.so的文件),不过我们推荐在开发扩展的时候使用静态编译,因为这样省去了在配置文件中加载扩展的步骤。
一切顺利的话,我们的第一个扩展就已经可以执行了:
手动创建扩展
大部分教程都是以ext_skel扩展骨架为原型讲述扩展开发的,这种做法当然很方便快捷。但是我个人更喜欢纯手工开发扩展的方式,因为这样更容易理解其中的每一个细节。
手动创建扩展,先进入ext目录,创建我们的扩展目录myext2。有几个文件是必须的:config.m4,myext2.c和php_myext2.h。
首先,我们来编写配置文件config.m4:
if test "PHP_MYEXT2" != "no"; then
PHP_NEW_EXTENSION(myext2, myext2.c, $ext_shared)
fi
PHP_ARG_ENABLE是PHP为autoconf定义的宏函数,myext2是它的第一个参数,指出了扩展的名字;后面两个参数只是在make和configure执行时用来显示的,所以我们可以随便写。[ ]在autoconf语法中的作用类似于双引号,用来包裹字符串(注意第二个参数中包含了空格,但是可以不用方括号起来)。还有第四个参数用来指明扩展默认是开启还是关闭(yes或no),默认是no。
下面三行其实就是shell语法,判断我们是否开启了PHP_MYEXT2扩展模块。如果开启了该扩展模块(--enable-myext2),则$PHP_MYEXT2变量的值不为no,因此执行PHP_NEW_EXTENSION宏。这个宏函数也是PHP为autoconf定义的扩展语法,第一个参数同样是扩展名称;第二个参数是扩展要编译的C文件,如果有多个,依次写下去就可以了(空格分隔);第三个参数固定是$ext_shared。
接下来编写php_myext2.h头文件,该文件的命名是PHP扩展的规范 — php_扩展名.h:
extern zend_module_entry myext2_module_entry;
#define phpext_myext2_ptr &myext2_module_entry
#define PHP_MYEXT2_VERSION "0.1.0"
/* prototypes */
PHP_FUNCTION(hello);
#endif /* PHP_MYEXT2_H */
这里主要的代码是定义了名为phpext_myext2_ptr的宏,PHP底层通过该宏来引用我们的扩展。可以看出,该宏的命名同样是有规范的 — phpext_扩展名_ptr。而myext2_module_entry是我们稍后要在.c文件里定义的结构体,它的命名也是规范的 — 扩展名_module_entry。
此外我们还定义了一个标识我们扩展版本号的宏和一个函数原型(通过PHP_FUNCTION宏,PHP_FUNCTION宏函数的参数是外部可使用的函数名),稍后我们会来实现这个函数。
最后来看下myext2.c文件的实现:
/* {{{ myext2_functions[]
*
* 每个用户可见的函数都必须在 myext2_functions[].
中有一个条目
*/
static const zend_function_entry myext2_functions[] = {
PHP_FE(你好, NULL)
PHP_FE_END
};
/* }}} */
/* {{{ myext2_module_entry
*/
zend_module_entry myext2_module_entry = {
STANDARD_MODULE_HEADER,
"myext2", /* 模块名称 */
myext2_functions, /* 模块函数 */
NULL, /* 模块初始化 */
NULL, /* 模块关闭 */
NULL, /* 请求初始化 */
NULL, /* 请求关闭 */
NULL, /* phpinfo */
PHP_MYEXT2_VERSION, /* 模块版本 */
标准模块属性
};
/* }}} */
#ifdef COMPILE_DL_MYEXT2
ZEND_GET_MODULE(myext2)
#endif
/* {{{ proto void hello()
打印“你好世界!” */
PHP_FUNCTION(你好)
{
php_printf("你好世界!n");
}
/* }}} */
对比下扩展重建创建的.c文件就能发现,我们的.c文件非常的简单,其实这些对一个协商的扩展来说就已经足够了。
上面的代码简单而清晰,大部分注释已经很说明性了。我们再简单粗暴地继续下:
1.目录包含了我们要用到的头必须文件。php.h是的,它已经帮我们包含了我们会用到的绝大部分的标准库文件,比如stdio.h,stdlib.h等等。
2.myext2_functions定义了由我们要导出的函数构成的结构体数组,每个元素都通过PHP_FE宏来指定。PHP_FE宏有两个参数,第一个是外部可使用的函数名,第二个是参数信息(这里我们简单地使用了NULL),最后一个元素必须是PHP_FE_END。注意它的注释,再次强调,每个要公开给外部使用的函数,都必须在该结构体数据库中有定义。
3.myext2_module_entry简单的定义了我们的模块信息,它是一个结构体,大部分属性都已经通过注释给出了说明。注意中间的五个函数指针,我们的置为NULL,在后续的博文中会讲述了它们的用法。
4.ZEND_GET_MODULE(myext2)宏函数是被ifdef宏包含的,所以说它是否调用是视情况而定的。至于什么情况下会被调用,什么情况下不会被调用,在后续的博文中会讲述。
5.最后几行代码我们实现了hello函数,很简单,调用php_printf输出hello world!跟一个行符,php_printf的实现和printf完全一样。
6. 注释里的 {{{ 和 }}} 是为了方便 vim 等编辑器折叠和使用的,我们推荐你也这样来写注释。
这里面涉及了一些简单的宏,比如PHP_FE,PHP_FE_END,PHP_FUNCTION等等,完整介绍这些宏要到后续的博文中才可以,眼下最的办法就是记住这些宏。
注意到我们每一个文件的命名,标记的命名,空格和缩进,以及注释等都是非常规范的,遵循这些规范,可以使我们编写的代码和PHP本身的代码更加契合,我们也推荐您使用这样的规范来开发 PHP 扩展。
最后,编译运行我们的扩展:
$ php-dev -m | grep myext2
myext2
$ php-dev -r 'hello();'
世界你好!