PHP扩展开发入门教程
PHP扩展开发
我准备在此系列博文中总结我有关PHP扩展开发的学习和感悟,力图简单清晰地描述在Linux系统下开发一个PHP扩展应该具备的最基本知识。水平较低,难免有错误,望指出。
准备工作
首先要获取一份PHP源码(可以从Github上签出,或者到官网上下载最新的稳定版),然后编译之。为了加快编译速度,我们推荐禁用所有额外的扩展(使用--disable-all选项),但最好打开debug(使用--enable-debug选项)和线程安全(使用--enable-maintainer-zts),但要在发布扩展的时候关闭debug,视情况选择是否需要打开线程安全:
$./buildconf--force $./configure--disable-all--enable-debug--enable-maintainer-zts $make
注意,我们没有指定--prefix选项(同时也没有makeinstall),因为这不是必须的。注意查看输出信息,也许你需要安装一些依赖包才能成功编译PHP。
编译后的PHP的可执行程序在源码的sapi目录下,对应不同的宿主环境有不同的子目录,我们以后都主要使用cli(commandlineinterface)环境,可以建一个别名方便引用:
$aliasphp-dev=/usr/local/src/php-5.6.5/sapi/cli/php
有一些命令行选项是很有用的:
php-dev-h#打印帮助信息 php-dev-v#打印版本信息 php-dev--ini#打印配置信息 php-dev-m#打印加载的模块信息 php-dev-i#phpinfo php-dev-r<code>#执行code里的代码
扩展骨架
PHP的所有官方扩展都在源码的ext目录下,我们自己写的扩展也可以放在该目录下。注意,该目录下有个名为ext_skel的shell脚本,它是用来生成PHP扩展骨架的,使用该脚本,可以帮我们快速创建PHP扩展:
$./ext_skel--extname=myext
上面的命令帮我们创建了一个名为myext的扩展,源码在myext目录下。不带任何参数的执行该脚本可以打印帮助信息,这样你可以查看到该脚本提供的更多选项。
接下来让我们完成我们的扩展。进入myext目录,编辑config.m4配置文件,找到PHP_ARG_ENABLE宏函数,去掉前面的dnl注释(共三行)。退回到源码根目录,重新执行buildconf、configure和make命令:
$./buildconf--force $./configure--help|grepmyext --enable-myext Enablemyextsupport $./configure--disable-all--enable-myext--enable-debug--enable-maintainer-zts $make
注意,我们用./configure--help|grepmyext打印了我们扩展的加载情况,如果看不到下面的输出,则说明我们的扩展没有配置成功,回头检查下config.m4文件。
这次编译应该非常快,因为大部分代码都已经编译过了。PHP还有另外一种编译扩展的方法(使用动态连接的方式,将扩展编译为.so的文件),不过我们推荐在开发扩展的时候使用静态编译,因为这样省去了在配置文件中加载扩展的步骤。
一切顺利的话,我们的第一个扩展就已经可以执行了:
$php-dev-m|grepmyext myext $php-dev-r'echoconfirm_myext_compiled("myext")."\n";' Congratulations!Youhavesuccessfullymodifiedext/myext/config.m4.ModulemyextisnowcompiledintoPHP.
第一个命令显示了我们的扩展已经被加载。第二个命令执行了ext_skel扩展骨架自动为我们创建的函数。当然,这个函数毫无意义,不过我们可以很容易的把这个函数改编成helloworld。
手动创建扩展
大部分教程都是以ext_skel扩展骨架为原型讲述扩展开发的,这种做法当然很方便快捷。但是我个人更喜欢纯手工开发扩展的方式,因为这样更容易理解其中的每一个细节。
手动创建扩展,先进入ext目录,创建我们的扩展目录myext2。有几个文件是必须的:config.m4,myext2.c和php_myext2.h。
首先,我们来编写配置文件config.m4:
PHP_ARG_ENABLE(myext2,whethertoenablemyext2support, [ --enable-myext2 Enablemyext2support])
iftest"PHP_MYEXT2"!="no";then PHP_NEW_EXTENSION(myext2,myext2.c,$ext_shared) fi