[TOC] 某个功能被编译到so文件中，那么如何通过php来调用它？一个方法是写一个php模块(php extension)，在php中调用该模块内的函数，再通过该模块来调用so中的函数。下面做一个简单的例子，使用的操作系统是RHEL5。 ### 制作.so文件 #### 首先做一个简单的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 */ ＃i nclude <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 = 7 ``` ### 为php添加扩展 #### 通过下面的命令建立一个名为 hello 的模块。 ``` $ ./ext_skel --extname=hello ``` 执行该命令之后它会提示你应当用什么命令来编译模块，可惜那是将模块集成到php内部的编译方法。如果要编译成可动态加载的 `php_hello.so`，方法要更为简单。 进入hello目录 ``` $ cd hello ``` 首先编辑 `config.m4`文件，去掉第16行和第18行的注释（注释符号为 dnl 。） ``` 16: PHP_ARG_ENABLE(hello, whether to enable hello support, 17: dnl Make sure that the comment is aligned: 18: [ --enable-hello Enable hello support]) ``` 然后执行 phpize 程序，生成configure脚本： ``` $ phpize ``` 然后打开 `php_hello.h`，在 PHP_FUNCTION(confirm_hello_compiled); 之下加入函数声明： ``` PHP_FUNCTION(confirm_hello_compiled); /* For testing, remove later. */ PHP_FUNCTION(hello_add); ``` 打开 hello.c，在 PHP_FE(confirm_hello_compiled, NULL) 下方加入以下内容。 ``` zend_function_entry hello_functions[] = { PHP_FE(confirm_hello_compiled, NULL) /* For testing, remove later. */ PHP_FE(hello_add, NULL) /* For testing, remove later. */ {NULL, NULL, NULL} /* Must be the last line in hello_functions[] */ }; ``` 然后在 hello.c 的最末尾书写hello_add函数的内容： ``` PHP_FUNCTION(hello_add) { long int a, b; long int result; if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ll", &a, &b) == FAILURE) { return; } result = hello_add(a, b); RETURN_LONG(result); } ``` #### hello.c文件的主要开发 ``` ZEND_BEGIN_ARG_INFO(arg_say_goodbye, 0) ZEND_ARG_INFO(0, name) ZEND_END_ARG_INFO() const zend_function_entry fetion_echo_functions[] = { PHP_FE(say_goodbye, arg_say_goodbye) {NULL, NULL, NULL} }; ZEND_BEGIN_ARG_INFO(name, 0|1) ``` 以`ZEND_BEGIN_ARG_INFO`宏定义开始，以`ZEND_END_ARG_INFO()`结束，这两个宏定义解释如下： ``` ZEND_BEGIN_ARG_INFO(name, pass_rest_by_reference)： 开始参数块定义，pass_rest_by_reference为1时，强制所有参数为引用类型 ZEND_END_ARG_INFO() ： 结束参数块定义 而每一个参数的定义可以是下列宏定义中的一个： ZEND_ARG_INFO 声明普通参数 ZEND_ARG_OBJ_INFO 声明对象类型的参数 ZEND_ARG_ARRAY_INFO 声明数组类型的参数 ZEND_ARG_PASS_INFO(pass_by_ref) pass_by_ref为1时，强制设置后续的参数为引用类型 ``` 举个例子，如果我们要定义一个函数user_login(username, password)，则参数的声明如下： ``` ZEND_BEGIN_ARG_INFO(arg_user_login, 0) ZEND_ARG_INFO(0, username) ZEND_ARG_INFO(0, password) ZEND_END_ARG_INFO() ``` 根据Zend API宏定义，上面的参数声明展开后，大致如下： ``` static const zend_arg_info arg_user_login[] = { \ { NULL, 0, NULL, 0, 0, 0, 0, 0, 0 }, { "username", sizeof(“username“)-1, NULL, 0, 0, 0, 0, 0, 0 }, { "password", sizeof(“password“)-1, NULL, 0, 0, 0, 0, 0, 0 }, } ``` 可以看到，其实我们定义参数信息展开后就是一个`zend_arg_info`结构数组，`zend_arg_info`结构定义如下： ``` typedef struct _zend_arg_info { const char *name; zend_uint name_len; const char *class_name; zend_uint class_name_len; zend_bool array_type_hint; zend_bool allow_null; zend_bool pass_by_reference; zend_bool return_reference; int required_num_args; } zend_arg_info; ``` 下面对各个字段做一解释： ``` name 参数名称 name_len 参数名称字符串长度 class_name 当参数类型为类时，指定类名称 class_name_len 类名称字符串长度 array_type_hint 标识参数类型是否为数组 allow_null 是否允许设置为空 pass_by_reference 是否设置为引用，即使用&操作符 return_reference 标识函数将重写return_value_ptr，后面介绍函数返回值时再做介绍 required_num_args 设置函数被调用时，传递参数至少为前N个，当设置为-1时，必须传递所有参数 ``` #### 保存退出，编译并安装： ``` $ ./configure $ make LDFLAGS=-lhello（重点） $ su # cp modules/hello.so /usr/lib/php/modules ./configure --with-php-config=/www/server/php/71/bin/php-config && make clean && make LDFLAGS=-lhello && make LDFLAGS=-lunionAPI && sudo make install ``` 然后在 `/var/www/html` 下建立一个 hello.php 文件，内容如下： 使用dl会报错（dl("hello.so");） ``` <?php echo hello_add(3, 4); ?> ``` ### 数据类型表格 ``` 类型指定符 对应的C类型 描述 l long 符号整数 d double 浮点数 s char *, int 二进制字符串，长度 b zend_bool 逻辑型（1或0） r zval * 资源（文件指针，数据库连接等） a zval * 联合数组 o zval * 任何类型的对象 O zval * 指定类型的对象。需要提供目标对象的类类型 z zval * 无任何操作的zval ``` [参考链接](https://www.cnblogs.com/doseoer/p/4367565.html)