php的c扩展

downmovies

在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, &param) == 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目录下面的那些扩展实例