写一个扩展最基本的便是编写函数。我这里是用skel死成了一个algorithm的扩展的骨架。
php扩展中的函数用PHP_FUNCTION宏定义。尾先正在.h文件中写一个定义，如skel死成的代码为例：PHP_FUNCTION(confirm_algorithm_compiled);
然后正在.c文件中写函数的实现。
PHP_FUNCTION(confirm_algorithm_compiled)
{
//...
}
这战传统的C编程很像。括号内便是函数的名字。这里出有参数列表，函数的参数是颠末其他途径获取的。然后，还需求正在扩展的函数进心表里增减一条：PHP_FE(confirm_algorithm_compiled, NULL)。这样正在php里才能找到这个函数。这里FE该当便是function entry的缩写。
zend_function_entry algorithm_functions[] = {
PHP_FE(confirm_algorithm_compiled, NULL)
{NULL, NULL, NULL} /* Must be the last line in algorithm_functions[] */
};
这里的{NULL, NULL, NULL}的传染打动如skel死成的代码中的注释所说，是函数进心表的完毕标识表记标帜。
函数返回值
php的api里定义了很多宏往实现扩展里函数的返回值。RETURN_BOOL、RETURN_LONG、RETURN_DOUBLE这3个宏拜别用于返回对应的值。只正在参数里填进需求返回的值即可。如RETURN_LONG(1024);。对付string，则有RETURN_STRING战RETURN_STRINGL。此中后者可以或许指定字符串的长度，前者只是以\0作为完毕标识表记标帜。第二个参数表示是可复造字符串的值。假定char数组是正在栈空间内分派的（如作为部分变量的字符串常量）便需求指定为1。
实践上，php的扩展中，函数的返回值是颠末一个return_value的变量往传递的。假定煮一下PHP_FUNCTION所展开的内容的话，会收现return_value实践上是这个函数的一个参数。前里那几个宏所作的工作便是，对return_value赋值然后return。对return_value赋值则尚有一组RETVAL_开尾的宏。如RETVAL_BOOL等。
获得参数
既然是函数总要能获取参数。正在php扩展里能颠末zend_parse_parameters()将参数解析为一些C的对应类型。
如
long foo;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &foo) == FAILURE) {
RETURN_NULL();
}
会试图解析参数为整数。将值放进foo。得利的时分，比如出有参数，或参数不克不及解析为整数时返回FAILURE。
这里的"l"表示整数。其他如"b"，"d"，"s"拜别表示布尔，浮点战字符串。资本数组工具等古后再说。
此中，布尔对应的C类型是zend_bool。其实便是0，1。浮点对应的是double。
对付字符串，则需求传进两个参数，拜别用于寄放字符串的值战长度。如
char *name;
int name_len;
zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s",
&name, &name_len);
此处由zend_parse_parameters分派的内存不需求手动开释。
假定需求解析多个参数，可以或许如下里的例子：
long foo;
char *name;
int name_len;
zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sl",
&name, &name_len, &foo);
zval战zvalue_value
之前一曲跳过的数组战工具，以及需求返回或者处置多品种型时，皆需求体味php内部是如何保存值的。
php内部保存值的基本单位是zval。它的C构造定义如下：
typedef struct _zval_struct {
zvalue_value value;
zend_uint refcount;
zend_uchar type;
zend_uchar is_ref;
} zval;
此中is_ref表示这个值是可是一个援引。
type表示值类型：有IS_NULL、IS_BOOL、IS_LONG、IS_DOUBLE、IS_STRING、IS_ARRAY、IS_OBJECT、IS_RESOURCE这8种。
refcount表示援引计数。
value寄放这个zval的值。
正在鉴定一个zval的值时，可以或许用如下的代码：
zval *a;
...
if (Z_TYPE_P(a) == IS_LONG){
...
}
zvalue_value中保存了zval的值，它的C构造定义如下：
typedef union _zvalue_value {
long lval;
double dval;
struct {
char *val;
int len;
} str;
HashTable *ht;
zend_object_value obj;
} zvalue_value;
这是一个union型，此中的lval、dval、str、ht、obj拜别表示整数、浮点、字符串、数组、工具。
获得一个zval的值当然也可以或许曲接从它的value里曲接取，不外更好的举措是颠末一套宏往获取。Z_BVAL、Z_LVAL_P、Z_DVAL_PP这样的情势。皆以Z_开尾，后里是类型，B便是boolean，L便是long，D便是double。后里可选的_P，_PP表示指针的层次。带_P是用往取zval*的，带_PP是用常常zval**的。这些宏返回的便是这个zval的值所对应的C类型。对付字符串，则有两组宏Z_STRVAL、 Z_STRLEN。后里当然也可以或许减_P战_PP。拜别返回char*战字符串的长度。这些宏使用很简单，例如：
zval* a;
...
long n;
n = Z_LVAL_P(a);
前里用到的Z_TYPE_P其实也是一个近似的宏，用于获得zval*的类型
有很多函数正在php手册里把参数或返回值类型写为mixed。那么正在扩展中是如哪里理的呢？所谓mixed常常便是曲接解析会返回zval。
先看参数处置，照样前里用过的zend_parse_parameters：
zval* item;
zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &item);
这很简单。
然后看返回值，返回zval可以或许用RETURN_ZVAL宏。战前里的RETURN_LONG之类不同的是，这个宏有3个参数。第一个参数便是一个zval*。第二个战第三个参数皆是0、1值。第二个参数是表示是可正在返回前复造该值；第三个参数是表示正在返回前是可调用析构函数。一样平居的用法是RETURN_ZVAL(p_zval, 1, 0);。为甚么一样平居要把复造zval设为1呢？这战php的内存筹划有关，关于内存筹划后里会说。这里大年夜要说下，由于php的垃圾收受接收是基于援引计数的。假定不复造一份，正在函数完毕后，由于返回值也是一个zval的指针，完毕后php会把这个zval的援引计数-1，正在一样平居环境下，这便会招致开释掉落不应开释掉落的内存，构成弊端。
内存筹划
正在C说话里，分派内存有一组alloc函数，比如malloc、calloc、realloc。php为了更方便，更安全地筹划内存，本身供给了一组内存分派的函数：emalloc、ecalloc、erealloc，另外尚有estrdup用于拷贝内存，efree用于开释由前里那些函数分派的内存。他们的用法战标准C函数的一样。这组e开尾的函数分派的内存空间只存正在于一次要求。正在要求完毕后，php会自动开释掉落。这便削减了由于出有开释掉落内存而构成的内存鼓露的大年夜概。
假定需求分派的内存正在整个进程运转时皆保持，而不是正在要求处置完毕后自动开释，则尚有一组pe开尾的函数，如pemalloc、pecalloc等。这组函数比标准C函数的多一个参数，即分派的内存是可持久，当这个参数为1时，即表示分派的是持久的内存，不会随着要求完毕而自动开释。如：pemalloc(sizeof(long) * 100, 1);。
另外，为了方便使用，还供给了safe_emalloc战safe_pemalloc这两个函数。 safe_emalloc的本型如下：void *safe_emalloc(size_t size, size_t count, size_t addtl);。参数拜别表示单位的大年夜小，单位的个数，以及偏移。实践分派的空间大年夜小便是size * count + addtl。safe_pemalloc与之近似。这两个函数尚有一个传染打动便是造止手工做上里的较劲争论时，大年夜概构成整数溢出，而招致分派的内存大年夜小小于预期或者是个负数。
援引计数
php接纳的内存筹划战垃圾收受接收要收是基于援引计数的。之前说过，正在zval构造里有一个refcount是表示援引计数，尚有一个is_ref表示是可是个援引变量。那么php代码的实践运转中，又是如哪里理的呢？
比如这样的php代码：
$a = "hello";
$b = $a;
这时候分并不像很多人感觉的那样，正在内存里把"hello"这个字符串复造了一份，而只是把$b指背了战$a对应的统一个zval，然后把那个zval的refcount + 1。这样造止了一次内存拷贝。但假定正在这之后改变了此中一个变量的值，比如$b.= " world";又会如何呢？这时候分才会分派一个新的zval给$b，然后把本先那个zval的refcount - 1。这便是传说中的copy on write。便是说，正在改变值得时分才会有内存拷贝。
那么援引变量又会如何呢？ 比如
$a = "hello";
$b = &$a;
战前里一样，$a, $b照样指背统一个zval。只是还要把这个zval的is_ref置为1。之后再改变$a或者$b的时分便不会再收生收水拷贝。那么
$a = "hello";
$b = &$a;
$c = $a;
这时候又会如何呢？由于$c并不是一个援引变量，是以不克不及战$a, $b共用一个zval。是以正在$c = $a的时分会曲领受死一个新的zval。
是以，正在php中，使用援引对改进机能并不会有多少传染打动，一样平居环境下还会使环境更糟。所以，援引照样只正在真正需求的时分才用为好。
再说说垃圾收受接收。每个zval皆有一个refcount表示它的变量的援引数。不管对付通俗变量照样援引变量皆是如此。refcount的初始值一样平居为1。每当删减一个援引时便+1，削减一个援引，比如unset时便会-1。当refcount为0的时分，php便会把它开释掉落。这便是基于援引计数的垃圾收受接收要收。
使用zval
初始化zval
MAKE_STD_ZVAL(zval*);
这个宏的旁边是创立一个zval，完成初始化（如将ref_count置为1，isref置为false）并把指针赋给参数。
赋值
写扩展的时分弗成造止的要用到把一个zval复造到另外一个zval，便是近似$a = $b;的操纵。对付简单的值大年夜概手动庇护援引计数之类的还不算很麻烦但对付数组，工具之类的便需求一层层递回进往，是以便有了一个zval_copy_ctor往做着件工作。
本有一个zval* p_zval_b，
zval* p_zval_a;
MAKE_STD_ZVAL(p_zval_a); //初始化p_zval_a
*p_zval_a = *p_zval_b;
zval_copy_ctor(p_zval_a);
这里，zval_copy_ctor完成了近似赋值的操纵，搜罗援引计数处置，对付hash值的成员处置等。
开释一个zval则是使用zval_ptr_dtor(**zval)。寄望它的参数。它会开释掉落为这个zval所分派的内存。
正在php中，很多工具皆是hash表。除了显而易睹的数组以外，其实工具的属性，函数进心表、变量的标识表记标帜表等正在php内部也皆是使用hash表往保存的。事实上，hash表里可以或许听任何一种数据类型的指针，并不限于zval*。
hash表的C构造叫HashTable。假定要创立一个HashTable，一样平居的做法如下：
HashTable *ht;
ALLOC_HASHTABLE(ht);
这样便会创立一个HashTable，并把地址放正在ht里。光有一个HashTable构造照样不止的，还需求初始化。这便需求用到zend_hash_init函数。声明如下：
int zend_hash_init(
HashTable *ht,
uint nSize,
hash_func_t pHashFunction,
dtor_func_t pDestructor,
zend_bool persistent
)
第一个参数便是一个HashTable指针，必须是已分派好内存的。
nSize是初始大年夜小，便是寄放工具的个数。跨越这个值时会自动扩展。假定这个值不是2的n次方，则会自动变成大年夜于它的最小的2的n次方数。
pHashFunction是出用的，但为了背下兼容，这个参数还正在哪里。必须为NULL。
pDestructor是析构函数。一样平居使用ZVAL_PTR_DTOR。
末端那个参数persistent是表示是用emalloc照样pemalloc往分派内存。
php的hash表可以或许有整数战字符串两种键，然后便有了两套会睹hash表的函数。hash相干函数皆以zend_hash_开尾。例如：
int zend_hash_update(HashTable *ht, char *arKey, uint nKeyLen, void *pData, uint nDataSize, void **pDest);
用往更新字符串键的值。arKey是键；nKenLen是键的长度，搜罗末端的'\0'；pData是值数据的指针，nDataSize是数据指针的大年夜小。末端一个参数是用往指定值数据指针的保存位置的，对付更新操纵一样平居用NULL即可而对付读取操纵，则用往放取出的值的指针。一个调用的例子：
zend_hash_update(pHash, "hello", sizeof("hello"), &pZval, sizeof(zval*), NULL);
其他几个hash操纵函数也大年夜同小同。
zend_hash_index_update用往更新整数键的值，zend_hash_find战zend_hash_index_find拜别用往读取字符串键战整数键所对应的值；zend_hash_exists战zend_hash_index_exists用往鉴定指定的键是可存正在；zend_hash_del战zend_hash_index_del用于删除。尚有很多其他的hash操纵函数。zend_hash_num_elements用于获得元素的个数；zend_hash_clean用于断根齐部元素；zend_hash_destroy除了断根齐部元素外，还会开释由zend_hash_init所分派的内存，完整销誉hash表。
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
