c 扩展

 

Linux下用C开发PHP扩展

一、首先下载PHP源码包，假设源码包目录为：/software/php-5.2.13 #> cd /software/php-5.2.13/ext   二、假设我们要开发一个名为caleng_module的扩展，该扩展包含两个函数：a--处理两个整型相加和b-处理字符串重复输出； 1、首先编写一个函数定义文件，该文件编写函数原型后缀为def，假设为：caleng_module.def int a(int x, int y) string b(string str, int n) 2、通过扩展骨架生成器，将在ext目录下自动建立扩展目录caleng_module #> ./ext_skel --extname=caleng_module --proto=caleng_module.def   3、修改配置文件: #> vim /software/php-5.2.13/ext/caleng_module/config.m4，将如下行的注释标签"dnl"去掉，修改后如下所示：   PHP_ARG_ENABLE(myfunctions, whether to enable myfunctions support, Make sure that the comment is aligned: [  --enable-myfunctions           Enable myfunctions support])     4、完善函数a和b的功能: #> vim /software/php-5.2.13/ext/caleng_module/caleng_module.c PHP_FUNCTION(a) {     double x, y, z;          double argc = ZEND_NUM_ARGS();       if (zend_parse_parameters(argc TSRMLS_CC, "dd", &x, &y) == FAILURE)         return;     z = x + y;     RETURN_DOUBLE(z); } PHP_FUNCTION(b) {     char *str = NULL;     int argc = ZEND_NUM_ARGS();     int str_len;     long n;     char *result;     char *ptr;     int result_length;       if (zend_parse_parameters(argc TSRMLS_CC, "sl", &str, &str_len, &n) == FAILURE)         return;     result_length = str_len * n;     result = (char *) emalloc(result_length + 1);     ptr = result;     while (n--) {         memcpy(ptr, str, str_len);         ptr += str_len;     }     *ptr = '/0';     RETURN_STRINGL(result, result_length, 0); } 三、编译安装，假设php的安装目录为:/usr/localhost/webserver/php #> cd /software/php-5.2.13/ext/caleng_module #> /usr/localhost/webserver/php/bin/phpize  #> ./configure --with-php-config=/usr/localhost/webserver/php/bin/php-config #> make #> make install 现在将在/usr/local/webserver/php/lib/php/extensions/no-debug-non-zts-20060613目录下生成caleng_module.so文件   在php.ini配置文件中加入: extension=caleng_module.so.   搞定收工！(深入研究可参考：http://blog.youkuaiyun.com/taft/archive/2006/02/10/596291.aspx)         下一个例子中,你将创建一个函数,它期望一个long (PHP的整数类型)、一个double (浮点)和一个可 选的Boolean 值。这个函数在用户空间的声明可能像这样: function hello_add($a, $b, $return_long = false) {     $sum = (int)$a + (float)$b;     if ($return_long) {         return intval($sum);     } else {         return floatval($sum);     } } 在C语言中,这个函数类似下面的代码(不要忘记在php_hello.h和hello.c的hello_functions[] 中加入相关条目以启用它): PHP_FUNCTION(hello_add) { long a; double b; zend_bool return_long = 0; if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ld|b", &a, &b, &return_long) == FAILURE) { RETURN_NULL(); } if (return_long) {     RETURN_LONG(a + b); } else {     RETURN_DOUBLE(a + b); } } 这次你的数据类型字符串读起来像:“我要一个long(l ),一个double(d )”。下一个管道字符表示其余的参数是可选的。如果函数调用时没有传入可选参数,那么zend_parse_parameters() 将不会改变传给它的对应变量。最后的b 当然是用于Boolean。数据类型字符串后面的是a 、b 和return_long ,它们按地址传递,这样zend_parse_parameters() 可以将值装入它们。 警告: 在32位平台中经常不加区分地使用int 和long ,但是,当你的代码在64位硬件上编译时,在本该使用一个的地方使用另一个是很危险的。所以记住要把long 用于整型,把int 用于字符串的长度。   ZEND_NUM_ARGS()告诉Zend引擎要取得的参数的信 息，TSRMLS_CC用来确保线程安全，返回值将被检查是SUCCESS还是FAILURE。 int zend_parse_parameters(int num_args TSRMLS_DC, char *type_spec, ...); 第一个参数 num_args 表明了我们想要接收的参数个数，我们经常使用 ZEND_NUM_ARGS() 来表示对传入的参数“有多少要多少”。第二参数应该总是宏 TSRMLS_CC 。第三个参数 type_spec 是一个字符串，用来指定我们所期待接收的各个参数的类型，有点类似于 printf 中指定输出格式的那个格式化字符串。剩下的参数就是我们用来接收 PHP 参数值的变量的指针 zend_parse_parameters() 在解析参数的同时会尽可能地转换参数类型，这样就可以确保我们总是能得到所期望的类型的变量。任何一种标量类型都可以转换为另外一种标量类型，但是不能在标量类型与复杂类型（比如数组、对象和资源等）之间进行转换。