linux下php实现C/C++扩展编程
某个功能被编译到so文件中,那么如何通过php来调用它?一个方法是写一个php模块(php extension),在php中调用该模块内的函数,再通过该模块来调用so中的函数。下面做一个简单的例子,使用的操作系统是Fedora Core 6。
首先做一个简单的so文件:
/**
* hello.c
* To compile, use following commands:
* gcc -O -c -fPIC -o hello.o hello.c
* gcc -shared -o libhello.so hello.o
*/
int hello_add(int a, int b)
{
return a + b;
}
然后将它编译成.so文件并放到系统中:
$ gcc -O -c -fPIC -o hello.o hello.c
$ gcc -shared -o libhello.so hello.o
$ su
# echo /usr/local/lib > /etc/ld.so.conf.d/local.conf
# cp libhello.so /usr/local/lib
# /sbin/ldconfig写段小程序来验证其正确性:
/**
* hellotest.c
* To compile, use following commands:
* gcc -o hellotest -lhello hellotest.c
*/
#include
int main()
{
int a = 3, b = 4;
printf("%d + %d = %d\n", a, b, hello_add(a,b));
return 0;
}
编译并执行:
$ gcc -o hellotest -lhello hellotest.c
$ ./hellotest
3 + 4 = 7OK,
下面我们来制作PHP模块。首先确保你安装了 php-devel 包,没有的话请自行从安装光盘上找。然后下载php源代码。我使用的是php-5.2.9.tar.gz,解压缩。
$ tar xzvf php-5.2.9.tar.gz
$ cd php-5.2.9/ext然后通过下面的命令建立一个名为 test 的模块。
$ ./ext_skel --extname=test执行该命令之后它会提示你应当用什么命令来编译模块,可惜那是将模块集成到php内部的编译方法。如果要编译成可动态加载的 php_test.so,方法要更为简单。
$ cd test首先编辑 config.m4 文件,去掉第16行和第18行的注释(注释符号为 dnl 。)
16: PHP_ARG_ENABLE(test, whether to enable test support,
17: dnl Make sure that the comment is aligned:
18: [ --enable-test Enable test support])然后执行 phpize ()程序,生成configure脚本:
$ phpize然后打开 php_test.h,在 PHP_FUNCTION(confirm_test_compiled); 之下加入函数声明:
PHP_FUNCTION(confirm_hello_compiled); /* For testing, remove later. */
PHP_FUNCTION(test_add);打开 hello.c,在 PHP_FE(confirm_test_compiled, NULL) 下方加入以下内容。
zend_function_entry test_functions[] = {
PHP_FE(confirm_test_compiled, NULL) /* For testing, remove later. */
PHP_FE(test_add, NULL) /* For testing, remove later. */
{NULL, NULL, NULL} /* Must be the last line in test_functions[] */
};
然后在 test.c 的最末尾书写test_add函数的内容:
PHP_FUNCTION(test_add)
{
long int a, b;
long int result;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ll", &a, &b) == FAILURE) {
return;
}
result = test_add(a, b);
RETURN_LONG(result);
}
保存退出,编译并安装:
$ ./configure --enable-jinzhesheng_module
--with-apxs=/usr/local/apache/bin/apxs
--with-php-config=/usr/local/php/bin/php-config$ make
# cp modules/test.so /usr/lib/php/modules然后在 /www/web/ 下建立一个 test.php 文件,内容如下:
dl("test.so");
echo test_add(1, 2);
?>
然后在浏览器中打开test.php文件,如果显示3,则说明函数调用成功了。
自己动手用 C 扩展 PHP(一)
作者: 黄浩
网名: black_key or ROOT1
mail: kkk139@126.com
环境要求: Linux, GCC
首先,我们应该选择如何去构建我们的扩展模块, 有三种方式:
1. External Modules
外部模块,也就是编译成共享库,用dl()函数动态加载。
好处: (1)不需要重新编译 PHP (2)PHP体积小,因为不需要编译进PHP
缺点: (1)每次*.php脚本执行都需要用 dl()去加载,效率较低
(2)每次都要调用dl()
2. Built-in Modules
编译进PHP
好处: (1)不需要动态加载,模块在php脚本里面可以直接使用.
(2)不需要将模块编译成.so共享库,因为直接编译进PHP。
缺点: (1)对模块的改变都需要重新编译PHP
(2)因为编译进PHP,所以PHP二进制文件较大,而且多占点内存
3. The Zend Engine
Zend 核心里实现 (略 ... 有兴趣的话可以看 Zend API)
Note: 本人推荐用 第 2 种方式,直接编译进PHP, 但是在下面示例里,我们编译成外部模块
,因为,外部模块不需要重新编译 PHP,所以在测试阶段先编译成共享库,然后用dl()
加载(不过记得在php.ini里将安全模式设为 Off),测试完后再用第2种方式重新编译进 PHP.
1. 首先下载 PHP 源代码, 解压。 然后我们开始构建代码结构,可以利用 PHP 源代码包ext目录里提供的 ext_skel 程序去生成我们需要的结构.
[ext]#./ext_skel --extname=haosoft_php_module
这样会在ext下生成一个 haosoft_php_module 目录。
目录里有 config.m4, haosoft_php_module.h, haosoft_php_module.c 等几个文件。
2. haosoft_php_module.h 为模块的头文件(熟悉C语言的应该了解), 用 VI 打开,删除其中的一行:
PHP_FUNCTION(confirm_MyExt_compiled); /* For testing, remove later. */
改为:
PHP_FUNCTION(haosoft_test); /* For testing, remove later. */
说明:
PHP_FUNCTION() 是一个 Zend Macro,作用是声名一个 C 函数,使他在 PHP 脚本里可用, 参数 是函数的名字,我们这里的示例函数为 haosoft_test.
3. haosoft_php_module.c 为主文件,里面包含了实现, VI 打开,我们删除掉
PHP_FUNCTION(confirm_MyExt_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.",
"haosoft_php_module", arg);
RETURN_STRINGL(string, len, 1);
}
增加:
PHP_FUNCTION(haosoft_test) {
zend_printf("This is my php module !");
}
4. 现在,我们开始编译我们的模块,因为要编译成 so,我们选择手工编译。
进入 ext 目录:
开始编译,编译成*.o对象文件,注意这个"-DCOMPILE_DL_HAOSOFT_PHP_MODULE",
在 haosoft_php_module.c 里你可以找到下面的语句
#ifdef COMPILE_DL_HAOSOFT_PHP_MODULE
ZEND_GET_MODULE(haosoft_php_module)
#endif
HAOSOFT_PHP_MODULE 是大写模块名,你可以换成其他名,但是必须保证这个预处理常量与
上面的语句里一致,至于上面语句的 ZEND_GET_MODULE(haosoft_php_module) 我们将在下一篇文
章讲解它的意思.
[ext]# cc -fpic -DCOMPILE_DL_HAOSOFT_PHP_MODULE=1 -I/usr/local/include
-I. -I../main -I.. -I../TSRM -I../Zend -c -o
haosoft_php_module/haosoft_php_module.o
haosoft_php_module/haosoft_php_module.c
执行完之后会在 目录下生成一个haosoft_php_module.o文件,接下来 连接:
[ext]# cc -shared -L/usr/local/lib -rdynamic -o
haosoft_php_module/haosoft_php_module.so
haosoft_php_module/haosoft_php_module.o
这样会在目录下生成了我们需要的 haosoft_php_module.so 文件。
然后我们要建立一个目录
[ext]# mkdir -p /usr/local/php/lib/php/extensions/no-debug-non-zts-20041030
上面的 20041030 的号码是Zend内部模块API号码,如果你不知道的话,你先建立一个php文
件:
test.php
dl("abc.so");
?>
在浏览器里运行该文件会出现错误信息, 可以在错误信息里得到这个号码,请根据自己情况根据这个号码与你的PHP安装目录更改路径。
建立完目录后接下来,我们把haosoft_php_module.so移动到刚刚的目录里去
[ext]# mv haosoft_php_module/haosoft_php_module.so /usr/local/php/lib/php/extensions/no-debug-non-zts-20041030
OK! 我们可以测试刚建立的模块了,目前模块里只有一个 haosoft_test() 的无参数方法。
建立 php 文件:
test.php
// 加载刚建立的模块
dl("haosoft_php_module.so");
// 调用函数
haosoft_test();
?>
执行。 看到显示 "This is my module !" 了吗?
5. 好了,模块编译,并测试无误后,我们可以将他编译进 PHP 了,回到 PHP源代码包根目录
执行:
[php-5.0.6]#./buildconf --force
[php-5.0.6]#./configure --enable-haosoft_php_module ... 也许你还有其他选项
[php-5.0.6]#make
[php-5.0.6]#make install
[php-5.0.6]#sh /etc/init.d/httpd restart ... 这里是重启 apache