PHP内核介绍及扩展开发指南——Extensions 的编写（三）

1.6访问PHP变量
1.6.1 设置

1.2.3节提到Zend使用HashTable来存储全局和局部变量符号，因此访问PHP变量，其实就是操作HashTable。当然，我们不需要手工去做，Zend提供了一组宏完成这些工作。
PHP变量的创建共有三步，首先需要创建一个zval结构，可使用如下的宏：


这个宏先调用emalloc分配一块zval，然后将其refcount设为1、is_ref设为0。
之后就是设置zval的值，同样，我们不需要直接操作zval的成员，Zend已经提供了如下的宏：


可能你会发现，这个表格和2.3节里面的返回值宏表格很相似，不错，返回值宏就是直接调用的ZVAL_xxx。
既然有了zval，下面把它添加到变量符号表里就可以了，可以使用如下的一组宏：


symtable用来指定你想插入的符号表，一般使用EG(active_symbol_table)，表示访问当前调用者的活动符号表。如果想强制访问全局符号表，可以用&EG(symbol_table)，这也正是ZEND_SET_GLOBAL_VAR(name, var)所做的。这两个宏的最终效果和执行PHP赋值语句name = var完全一样。
如果只是访问全局变量，可以使用单个宏代替上述三步：


上述宏分别用于创建全局的string、long和double变量，它们在内部执行了以上三步，当然，最后调用的是ZEND_SET_GLOBAL_VAR宏。
1.6.2 获取

如果想获取已有的PHP变量，则只能直接访问HashTable，Zend并没有提供相应的操作：


这个函数从HashTable中查找元素，pData用于获取结果值，Bucket.pData将被放到这里（如果找到的话）。函数成功则返回SUCCESS，否则返回FAILURE。
下面是个示例：


这段代码从活动符号表中查找名为var的变量，需要注意的是nKeyLength是4，必须包括结尾的0。
获得变量后，拿来读是没有问题的，但是写操作就应该小心对待了。只有当refcount为1或者is_ref为1，才可以写入；否则应该进行zval分离，具体参见1.2.3节。
1.6.3 常量

PHP常量的内部定义如下：


常量的值依然使用zval存储，但这里的zval是私有的，不会和其他变量或常量共享，其refcount和is_ref被忽略。module_number是模块号，在启动函数中可以获取该值（参见2.4），当模块被卸载时，Zend会使用模块号查找和删除所有该模块注册的常量。如果希望在模块被卸载后，常量依然有效，可以将module_number设为0。另一个注意点是，name_len需要包含结尾的0。
flags值可以是如下两个，可以使用”|”联用：

所有常量都被放在EG(zend_constants)这张HashTable里，其key是常量名称，value是zend_constant，注意不是zend_constant*，因此HashTable会复制一份zend_constant作为value。
获取一个常量非常简单，只要传递常量名和接受常量值的zval：


设置常量稍微复杂一点，需要先填写一个zend_constant结构，要注意的是，常量只能是long、double和string。然后使用如下函数将其加入常量表：
同时，Zend也为我们提供了如下的宏，可以直接创建常量：


REGISTER_LONG_CONSTANT(name, value, flags)REGISTER_MAIN_LONG_CONSTANT(name, value, flags)
REGISTER_DOUBLE_CONSTANT(name, value, flags)REGISTER_MAIN_DOUBLE_CONSTANT(name, value, flags)
REGISTER_STRING_CONSTANT(name, value, flags)REGISTER_MAIN_STRING_CONSTANT(name, value, flags)
REGISTER_STRINGL_CONSTANT(name, value, length, flags)REGISTER_MAIN_STRINGL_CONSTANT(name, value, length, flags)
上述宏的MAIN版本用于创建module_number为0的宏，在模块被卸载后，常量依然有效。而非MAIN版本则假设存在一个名为module_number的int变量，并拿来给zend_constant.module_number赋值，可见这组宏原本就是为在模块启动函数里调用而设计的。另外，当创建string型常量时，Zend也会dup一份字符串，因此可以直接使用C串指定常量值。
最后需要指出的是，上述函数和宏都无法改变已有的常量，如果发现已经存在同名常量，则函数失败。如果想修改的话，只能通过HashTable操作。

1.7输出信息
Zend提供了两个函数用于向浏览器输出信息：


zend_printf用法和C的printf一样；zend_error用于输出错误信息，type可以指定错误的性质，对于不同的错误，Zend将作不同处理：
错误码 处理
E_ERROR 严重错误，立即终止脚本运行。
E_WARNING 警告， 脚本继续执行。
E_PARSE 解析错误，解析器复位，脚本继续执行。
E_NOTICE 通知，脚本继续执行。该信息默认情况下不予输出，可以修改php.ini来启用。
该函数会同时输出出错的文件和行号，类似这样：