php的c扩展

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