项目做了快半年了，关于php的扩展模块开发，从完全不懂到边查资料边摸索，到现在的灵活运用，其间也经历了不少的困惑期，在此以文章记录，希望对有同样需求的人起到一定的帮助作用。

一. 生成一个简单的php extension

我们需要两个目录：php src，php bin，到网上下载一个php源码包，解压，安装。

php的解压目录记为 phpsrc（如：/home/src/php-4.4.4） ,安装目录记为 phpbin（如 /usr/local/php）
在shell下输入（以后遇到有shell的地方我就用#开头，不另陈述）

# cd phpsrc/ext
# ./ext_skel --extname=test_module

Creating directory test_module
Creating basic files: config.m4 .cvsignore test_module.c php_test_module.h CREDITS EXPERIMENTAL tests/001.phpt test_module.php [done].

To use your new extension, you will have to execute the following steps:

1. $ cd ..
2. $ vi ext/test_module/config.m4
3. $ ./buildconf
4. $ ./configure --[with|enable]-test_module
5. $ make
6. $ ./php -f ext/test_module/test_module.php
7. $ vi ext/test_module/test_module.c
8. $ make

Repeat steps 3-6 until you are satisfied with ext/test_module/config.m4 and
step 6 confirms that your module is compiled into PHP. Then, start writing
code and repeat the last two steps as often as necessary.

系统自动生成 test_module文件夹；接下来我们要修改几个文件：config.m4, test_module.c,php_test_module.h, 如下：

1) 修改config.m4

# cd test_module
# vi config.m4

找到这几行

dnl PHP_ARG_ENABLE(test_module, whether to enable test_module support，

dnl Make sure that the comment is aligned:
dnl [ --enable-test_module Enable test_module support])
去掉这几行前面的dnl，改为
PHP_ARG_ENABLE(test_module, whether to enable test_module support，

Make sure that the comment is aligned:
[ --enable-test_module Enable test_module support])

这样以后编译php时，./configure后面加 --enable-test_module 就可以加载你的php模块了！

（接下来的2）你可以做也可以不做，直接跳到第4步也可以运行。）

2) 修改test_module.c，输出自己想要的东西

# vi test_module.c


找到这段
PHP_FUNCTION(confirm_test_module_compiled)
{
char *arg = NULL;
int arg_len, len;
char string[256];

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &arg, &arg_len) == FAILURE) {
return;
}

len = sprintf(string, "Congratulations! You have successfully modified ext/%.78s/config.m4. Module %.78s is now compiled into PHP.", "test_module", arg);
RETURN_STRINGL(string, len, 1);
}
改为：
PHP_FUNCTION(confirm_test_module_compiled)
{
zend_printf("This is a test module !");
}

3）编译链接

# cd phpsrc/ext
# cc -fpic -DCOMPILE_DL_TEST_MODULE=1 -I/usr/local/include -I. -I../main -I.. -I../TSRM -I../Zend -c -o test_module/test_module.o test_module/test_module.c

执行完之后会在 目录下生成一个test_module.o文件，接下来连接：

# cc -shared -L/usr/local/lib -rdynamic -o test_module/test_module.so test_module/test_module.o

4）测试：

有两种途径可以测试你的扩展模块是否正确，一是在phpbin目录下运行test.php, 二是在web browser上运行test.php（如果已经安装apache等web服务器的话）。

这里采用phpbin测试，不需要任何web服务器。

拷贝test_module.so到phpbin的相应目录下

（如果不知道是哪个目录，或者没有拷贝到正确的位置，在运行的时候出错信息里会指出应该在什么路径。）
# mkdir -p phpbin/lib/php/extensions/ （其实这个目录就是看你php.ini里设置extension_dir了）
# cp test_module/test_module.so phpbin/lib/php/extensions/

在phpbin目录下新建一个test.php文件，在里面写入


dl("test_module.so");

//调用函数

test_module();

?>

在phpbin目录下运行
执行./php –q test.php，如果过程无误，将会显示：
This is a test module !

测试成功，接下来我们可以往扩展模块中添加自己的函数，实现自己的功能啦。


二. 向扩展模块中添加函数

向php扩展模块中添加函数，只需要修改test_module.c和php_test_module.h。

比如要向扩展模块中添加一个函数sayhello(),我们需要做以下工作：

1） 修改 php_test_module.h 添加函数声明
在文件中PHP_FUNCTION(confirm_my_module_compiled);一行前面添加下面的代码
PHP_FUNCTION(say_hello);
保存文件退出

2） 修改 test_module.c

在function_entry中添加函数的entry：

function_entry my_module_functions[] = {
PHP_FE(say_hello, NULL) /* ß添加着一行代码 */
PHP_FE(confirm_my_module_compiled, NULL) /* For testing, remove later. */
{NULL, NULL, NULL} /* Must be the last line in my_module_functions[] */
};

在文件的最后添加函数的实现：
PHP_FUNCTION(say_hello)
{
zend_printf("hello world/n");
}
保存文件退出

3）重新编译链接，生成新的.so文件。

# cd phpsrc/ext
# cc -fpic -DCOMPILE_DL_TEST_MODULE=1 -I/usr/local/include -I. -I../main -I.. -I../TSRM -I../Zend -c -o test_module/test_module.o test_module/test_module.c

执行完之后会在 目录下生成一个test_module.o文件，接下来连接：

# cc -shared -L/usr/local/lib -rdynamic -o test_module/test_module.so test_module/test_module.o


三. 调用第三方C/C++库

在PHP扩展模块中调用第三方的C/C++库，与普通的C/C++程序调用C/C++库一样，只要把库文件的位置放对就可以了。下面举例说明：

1. 调用动态库a.so

需要的文件，a.so，a.h（a.h主要做数据类型声明和入口函数声明），都放在 test_module目录下。

调用a.so：

1） 在test_module.c的开头添加a.h：

#include "php.h

#include "php_ini.h"
#include "a.h"
添加了头文件后，可以在test_module.c的函数中调用a.so的函数接口。

2） 重新编译链接，链接时加入a.so：

# cd phpsrc/ext
# cc -fpic -DCOMPILE_DL_TEST_MODULE=1 -I/usr/local/include -I. -I../main -I.. -I../TSRM -I../Zend -c -o test_module/test_module.o test_module/test_module.c

执行完之后会在 目录下生成一个test_module.o文件，接下来连接：

# cc -shared -L/usr/local/lib -rdynamic -o test_module/test_module.so test_module/test_module.o test_module/a.so

[如果a.so内部实现是C++，链接时还应该加入参数 –lstdc++，即：

# cc –shared –lstdc++ -L/usr/local/lib -rdynamic -o test_module/test_module.so test_module/test_module.o test_module/a.so

]

3) 测试test_module.so时，把test_module.so和a.so都拷贝到phpbin/lib/php/extensions/下。

2. 调用静态库a.a

需要的文件，a.so，a.h（a.h主要做数据类型声明和入口函数声明），都放在 test_module目录下。

调用a.a：

1) 和2）都与调用a.so相同。

3) 测试test_module.so时，把test_module.so拷贝到phpbin/lib/php/extensions/下，a.a不需要。