PHP的C扩展

dly · 发表于 2012-4-14 09:50:52

在php中最核心的一个数据结构就是这个：

typedef　union　_zvalue_value　{　
　long　lval;　　　/*　long　value　*/　
　double　dval;　　/*　double　value　*/　
　struct　{　
　char　*val;　
　int　len;　
　}　str;　
　HashTable　*ht;　　/*　hash　table　value　*/　
　zend_object_value　obj;　
}　zvalue_value;　
　
　
struct　_zval_struct　{　
　/*　Variable　information　*/　
　zvalue_value　value;　/*　value　*/　
　zend_uint　refcount;　
　zend_uchar　type;　/*　active　type　*/　
　zend_uchar　is_ref;　
};

复制代码

这个数据结构也就是php中的每个数据类型在下层c语言中的表示。可以看到_zval_struct 结构体第一个字段是一个联合体，他来存储实际的值，这些值可以为long，double，字符串，hashtable（也就是php中的数组）和对象。而第2个参数是个引用计数，第三个参数是当前的类型。　　也就是说php中的每个类型实际都是一个 struct _zval_struct类型。
　　1 首先进入php的源码目录下的ext文件夹，然后运行下面的命令,这样将会生成一个my_module的文件夹。：

./ext_skel　--extname=my_module

复制代码

2 然后在my_module.h里面声明你的php函数名：

PHP_FUNCTION(my_function);

复制代码

2 在my_module.c文件的my_module_functions(这里的module就是你所创建的扩展模块名字)加入你所要写的php方法名:

PHP_FE(my_function,　NULL)

复制代码

3 接下来就实现PHP_FUNCTION(my_function)。　　首先参数的解析，当传递进来的php的类型和c的类型之间的转换：
　　这里要用到的函数是：

int　zend_parse_parameters(int　num_args　TSRMLS_DC,　char　*type_spec,　...);

复制代码

其中的php类型和c类型的对应如下：　　引用
　　l - long
　　d - double
　　s - string (with possible null bytes) and its length
　　b - boolean
　　r - resource, stored in zval*
　　a - array, stored in zval*
　　o - object (of any class), stored in zval*
　　O - object (of class specified by class entry), stored in zval*
　　z - the actual zval*
　　这边就看到了，这里的zval也就是一开始介绍的那个php的类型结构体。
　　这边还可以使用三个符号：
　　| - 这个也就是或者的意思
　　/ -将会提供当前参数的一个副本。
　　! - 这个符号他必须进跟在a, o, O, r, z 的后面，也就是说当传递进来的参数为NULL的时候，我们pass的那个指针也会被NULL。
　　例子：

/*　得到一个long，string和一个zval　*/　
long　l;　
char　*s;　
int　s_len;　
zval　*param;　
if　(zend_parse_parameters(ZEND_NUM_ARGS()　TSRMLS_CC,　
　　　　　　　　　　　　　"lsz",　&l,　&s,　&s_len,　¶m)　==　FAILURE)　{　
　　return;　
}　
　
/*传递进来的为一个对象或者一个double　*/　
zval　*obj;　
double　d　=　0.5;　
if　(zend_parse_parameters(ZEND_NUM_ARGS()　TSRMLS_CC,　
　　　　　　　　　　　　　"O|d",　&obj,　my_ce,　&d)　==　FAILURE)　{　
　　return;　
}　
　
/*　传递进来的参数为NULL或者一个对象和一个数组　*/　
zval　*obj;　
zval　*arr;　
if　(zend_parse_parameters(ZEND_NUM_ARGS()　TSRMLS_CC,　"O!a",　&obj,　&arr)　==　FAILURE)　{　
　　return;　
}　
　
/*　得到一个数组　*/　
zval　*arr;　
if　(zend_parse_parameters(ZEND_NUM_ARGS()　TSRMLS_CC,　"a/",　&arr)　==　FAILURE)　{　
　　return;　
}　
　
/*得到前三个参数　*/　
zval　*z;　
zend_bool　b;　
zval　*r;　
if　(zend_parse_parameters(3,　"zbr!",　&z,　&b,　&r)　==　FAILURE)　{　
　　return;　
}

复制代码

当我们传递进来的为一个数组的时候我们该如何遍历这个数组呢，看下面的代码：

zval　*param;　
　　　　HashPosition　pos;　
　　　　zval　**data_value;　
　　　　if　(zend_parse_parameters(ZEND_NUM_ARGS()　TSRMLS_CC,　"a",　&(param))　==　FAILURE)　{　
　　　RETURN_FALSE;　
　　　}　
//遍历数组.　
　　　　for　(zend_hash_internal_pointer_reset_ex(Z_ARRVAL_P(param),　&pos);　
　　zend_hash_get_current_data_ex(Z_ARRVAL_P(param),　(void　**)&data_value,　&pos)　==　SUCCESS;　
　　zend_hash_move_forward_ex(Z_ARRVAL_P(param),　&pos))　
　　　　{　
　　　　　　//现在数组里面的值就存储在data_value这个指针里面，我们可以通过对他解引用来提取值，比如假设有个元素是long的，那么我们就可以这样来取(就是根据一开头介绍的那个数据结构来取)：　
　
long　temp=(*data_value)->value.lval;　
　　　　}

复制代码

接下来是返回值的问题,这里定义了好几个宏：

RETURN_RESOURCE(int　r)　
RETURN_BOOL(int　b)　　
RETURN_NULL(　)　
RETURN_LONG(int　l)　　
RETURN_DOUBLE(double　d)　　
RETURN_STRING(char　*s,　int　dup)　　
RETURN_STRINGL(char　*s,　int　l,　int　dup)　　
RETURN_EMPTY_STRING(　)　　
RETURN_FALSE　　
RETURN_TRUE

复制代码

比如我要返回个字符串，可以这么写：

　RETURN_STRING("banana",　1);

复制代码

这里讲下返回一个数组的问题,下面的代码是返回一个嵌套数组：

zval　*param:　
　
array_init(param);　
//return_value是一个全局的变量（我是这么理解的）　
array_init(return_value);　
add_index_string(param,　0,　"sad",1);　
add_index_zval(return_value,0,　param);

复制代码

PS:更详细的还是要看ext目录下面的那些扩展实例

PHP的C扩展

相关帖子