某个功能被编译到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 <stdio.h>
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 文件,内容如下:
<?php
dl("test.so");
echo test_add(1, 2);
?>
然后在浏览器中打开test.php文件,如果显示3,则说明函数调用成功了
PHP_ARG_WITH或者PHP_ARG_ENABLE指定了PHP模块的工作方式,任选一种,我选择的是WITH
PHP_REQUIRE_CXX用于指定这个扩展用到了C++
PHP_SUBST(EXTERN_NAME_SHARED_LIBADD)用于说明这个扩展编译成动态链接库的形式
PHP_ADD_LIBRARY(stdc++,"",SYSFILE_SHARED_LIBADD)用于将标准C++库链接进入扩展
PHP_NEW_EXTENSION用于指定有哪些源文件应该被编译,文件和文件之间用空格隔开
ext_skel默认生成的模块框架是针对C的,我们要使用C++, 那以上的3,5两个宏就是必须的.另外还要把testext.c改名成testext.cpp,所以PHP_NEW_EXTENSION原本包括的testext.c也要修改.
-
在使用C++之后要注意一个小问题,那就是php_testext.h这个文件可能被PHP的其他部分所引用到,而引用者很可能是一个.c文件,所以不能在php_testext.h里包含任何C++所独有的东西.比如标准模版库,类,或者bool类型等等.
-
默 认生成的testext.c(现在改名为testext.cpp)了,已经包含了一个测试性质的导出函数,通过那个例子就可以大概明白怎么添加自己的函数 了. zend_function_entry是导出函数列表, zend_module_entry描述了模块的信息. 不过因为是C++了,还是有几点要修改的:
-
#include "php.h" #include "php_ini.h" #include "ext/standard/info.h"
要用extern "C" 修饰.
-
ZEND_GET_MODULE也要用extern "C"修饰
-
zend_module_entry就是用于描述模块信息的类型,其实就是一个结构,其中第二项不知道是什么含意.在Windows上,这好像是一个描述信息,可以是一个长长的字符串,但是在Linux上似乎只能是跟模块名相同.
-
-
之后的工作就是写自己的代码了.根据设计,提供对外的接口函数,然后写C/C++代码来实现.