名站导航为爱好php程序的朋友们提供php相关的教程知识。
当你在扩展中使用hashTable时候，95%是要存储用户端的变量，就像PhP程序语言中数组那样。为此，内核中已经准备好了相应的工具，来让我们更加的方便的操作hashTable存储zval*，也就是PhP程序语言中的数组，即IS_ARRAY常量代表的zval，以下用{数组}来代替PhP程序语言中的数组这个词。
创建数组
创建hashTable有些繁琐，虽然有辅助的宏但还是不能一步完成，而创建数组便简单多了，直接使用array_init(zval *arrval)函数即可，注意它的参数是zval*类型的！这样，我们像用户端返回数组便简单多了：
ZEND_FUNCTION(sample_array)
{
array_init(return_value);
}
//return_value是zval*类型的，所以我们直接对它调用array_init()函数即可，即把它初始化成了一个空数组。
添加元素
将数组初始化后，接下来就要向其添加元素了。因为PhP程序语言中有多种类型的变量，所以也对应的有多种类型的add_assoc_*()、add_index_*、add_next_index_*()函数。如：
array_init(arrval); add_assoc_long(zval *arrval, char *key, long lval); add_index_long(zval *arrval, ulong idx, long lval); add_next_index_long(zval *arrval, long lval);
这三个函数的第一个参数都要被操作的{数组}指针，然后是索引值，最后是变量，唯一不同的是add_next_index_long()函数的索引值是其自己计算出来的。根据上一节的内容我们可以知道，这三个函数分别在内部使用了zend_hash_update()、zend_hash_index_update()与zend_hash_next_index_insert函数。
//add_assoc_*系列函数： add_assoc_null(zval *aval, char *key); add_assoc_bool(zval *aval, char *key, zend_bool bval); add_assoc_long(zval *aval, char *key, long lval); add_assoc_double(zval *aval, char *key, double dval); add_assoc_string(zval *aval, char *key, char *strval, int dup); add_assoc_stringl(zval *aval, char *key,char *strval, uint strlen, int dup); add_assoc_zval(zval *aval, char *key, zval *value); //备注：其实这些函数都是宏，都是对add_assoc_*_ex函数的封装。 //add_index_*系列函数： ZEND_API int add_index_long (zval *arg, ulong idx, long n); ZEND_API int add_index_null (zval *arg, ulong idx ); ZEND_API int add_index_bool (zval *arg, ulong idx, int b ); ZEND_API int add_index_resource (zval *arg, ulong idx, int r ); ZEND_API int add_index_double (zval *arg, ulong idx, double d); ZEND_API int add_index_string (zval *arg, ulong idx, const char *str, int duplicate); ZEND_API int add_index_stringl (zval *arg, ulong idx, const char *str, uint length, int duplicate); ZEND_API int add_index_zval (zval *arg, ulong index, zval *value); //add_next_index_long函数： ZEND_API int add_next_index_long (zval *arg, long n ); ZEND_API int add_next_index_null (zval *arg ); ZEND_API int add_next_index_bool (zval *arg, int b ); ZEND_API int add_next_index_resource (zval *arg, int r ); ZEND_API int add_next_index_double (zval *arg, double d); ZEND_API int add_next_index_string (zval *arg, const char *str, int duplicate); ZEND_API int add_next_index_stringl (zval *arg, const char *str, uint length, int duplicate); ZEND_API int add_next_index_zval (zval *arg, zval *value);
每组函数最后的一个，即zend..._zval()函数，允许我们像这个{数组}中添加资源、对象、{数组}等复合类型的PhP程序变量。下面让我们通过一个例子来演示下它们的用法：
ZEND_FUNCTION(sample_array)
{
zval *subarray;
array_init(return_value);
/* Add some scalars */
add_assoc_long(return_value, "life", 42);
add_index_bool(return_value, 123, 1);
add_next_index_double(return_value, 3.1415926535);
/* Toss in a static string, dup'd by PhP程序 */
add_next_index_string(return_value, "Foo", 1);
/* Now a manually dup'd string */
add_next_index_string(return_value, estrdup("Bar"), 0);
/* Create a subarray */
MAKE_STD_ZVAL(subarray);
array_init(subarray);
/* Populate it with some numbers */
add_next_index_long(subarray, 1);
add_next_index_long(subarray, 20);
add_next_index_long(subarray, 300);
/* Place the subarray in the parent */
add_index_zval(return_value, 444, subarray);
}
这时如果我们用户端var_dump这个函数的返回值便会得到：
<?php var_dump(sample_array()); ?>
输出：
array(6)
{
["life"]=> int(42)
[123]=> bool(true)
[124]=> float(3.1415926535)
[125]=> string(3) "Foo"
[126]=> string(3) "Bar"
[444]=> array(3)
{
[0]=> int(1)
[1]=> int(20)
[2]=> int(300)
}
}
好了关于php程序的知识就说到这里希望可以帮助需要的朋友。,PhP程序内核探索：数组源码分析
PhP程序大部分功能，都是通过hashTable来实现，其中就包括数组。hashTable即具有双向链表的优点，同时具有能与数据匹敌的操作性能。PhP程序中的定义的变量保存在一个符号表里，而这个符号表其实就是一个hashTable，它的每一个元素都是一个zval*类型的变量。不仅如此，保存用户定义的函数、类、资源等的容器都是以hashTable的形式在内核中实现的。
