红联Linux门户
Linux帮助

Linux下php扩展模块开发

发布时间:2007-07-04 09:46:51来源:红联作者:Dcsaqois
项目做了快半年了,关于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不需要。
文章评论

共有 0 条评论