PHP扩展开发入门教程

 这篇文章主要介绍了PHP扩展开发入门教程,本文讲解了使用C语言在Linux系统下开发一个PHP扩展应该具备的最基本知识,需要的朋友可以参考下

PHP扩展开发

我准备在此系列博文中总结我有关PHP扩展开发的学习和感悟，力图简单清晰地描述在Linux系统下开发一个PHP扩展应该具备的最基本知识。水平较低，难免有错误，望指出。

准备工作

首先要获取一份PHP源码（可以从Github上签出，或者到官网上下载最新的稳定版），然后编译之。为了加快编译速度，我们推荐禁用所有额外的扩展（使用--disable-all选项），但最好打开debug（使用--enable-debug选项）和线程安全（使用--enable-maintainer-zts），但要在发布扩展的时候关闭debug，视情况选择是否需要打开线程安全：

编译后的PHP的可执行程序在源码的sapi目录下，对应不同的宿主环境有不同的子目录，我们以后都主要使用cli（command line interface）环境，可以建一个别名方便引用：

有一些命令行选项是很有用的：

扩展骨架

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 */