# 2.3 创建PHP变量
# 2.3 创建PHP变量
我们已经知道php变量在内核中其实是通过zval结构来实现的,也初步了解如何设置一个zval结构的类型和值。 这一节我们将在前两节的基础上,彻底掌握对zval结构的操控,其间将引入很多超棒的新宏。
在code的时候,很希望在内核中创建的zval可以让用户在PHP语言里以变量的形式使用,为了实现这个功能, 我们首先要创建一个zval。最容易想到的办法便是创建一个zval指针, 然后申请一块内存并让指针指向它。如果你脑海里浮现出了malloc(sizeof(zval))的影子, 那么请你立即刹车,不要用malloc来做这件事情,内核给我们提供了相应的宏来处理这件事, 理由和以前一样:为了代码漂亮并保持版本升级时的兼容性。 这个宏是:MAKE\_STD\_ZVAL(pzv)。这个宏会用内核的方式来申请一块内存并将其地址付给pzv, 并初始化它的refcount和is\_ref两个属性,更棒的是,它不但会自动的处理内存不足问题, 还会在内存中选个最优的位置来申请。
> 除了MAKE\_STD\_ZVAL()宏函数,ALLOC\_INIT\_ZVAL()宏函数也是用来干这件事的, 唯一的不同便是它会将pzv所指的zval的类型设置为IS\_NULL;
申请完空间后,我们便可以给这个zval赋值了。基于已经介绍的宏, 也许我们需要Z\_TYPE\_P(p) = IS\_NULL来设置其是null类型,并用Z\_SOMEVAL形式的宏来为它赋值, 但是现在你有了更好更短的选择!
内核中提供一些宏来简化我们的操作,可以只用一步便设置好zval的类型和值。
新宏 其它宏的实现方法 ZVAL\_NULL(pvz); \*\*(注意这个Z和VAL之间没有下划线!)\*\* Z\_TYPE\_P(pzv) = IS\_NULL;\*\*(IS\_NULL型不用赋值,因为这个类型只有一个值就是null,^\_^)\*\* ZVAL\_BOOL(pzv, b); \*\*(将pzv所指的zval设置为IS\_BOOL类型,值是b)\*\* Z\_TYPE\_P(pzv) = IS\_BOOL; Z\_BVAL\_P(pzv) = b ? 1 : 0; ZVAL\_TRUE(pzv); \*\*(将pzv所指的zval设置为IS\_BOOL类型,值是true)\*\* ZVAL\_BOOL(pzv, 1); ZVAL\_FALSE(pzv); \*\*(将pzv所指的zval设置为IS\_BOOL类型,值是false)\*\* ZVAL\_BOOL(pzv, 0); ZVAL\_LONG(pzv, l); \*\*(将pzv所指的zval设置为IS\_LONG类型,值是l)\*\* Z\_TYPE\_P(pzv) = IS\_LONG;
Z\_LVAL\_P(pzv) = l; ZVAL\_DOUBLE(pzv, d); \*\*(将pzv所指的zval设置为IS\_DOUBLE类型,值是d)\*\* Z\_TYPE\_P(pzv) = IS\_DOUBLE;
Z\_DVAL\_P(pzv) = d; ZVAL\_STRINGL(pzv,str,len,dup);\*\*(下面单独解释)\*\* Z\_TYPE\_P(pzv) = IS\_STRING;
Z\_STRLEN\_P(pzv) = len;
if (dup)
{Z\_STRVAL\_P(pzv) =estrndup(str, len + 1);}
else
{Z\_STRVAL\_P(pzv) = str;} ZVAL\_STRING(pzv, str, dup); ZVAL\_STRINGL(pzv, str,strlen(str), dup); ZVAL\_RESOURCE(pzv, res); Z\_TYPE\_P(pzv) = IS\_RESOURCE;
Z\_RESVAL\_P(pzv) = res;### ZVAL\_STRINGL(pzv,str,len,dup)中的dup参数
先阐述一下ZVAL\_STRINGL(pzv,str,len,dup); str和len两个参数很好理解,因为我们知道内核中保存了字符串的地址和它的长度, 后面的dup的意思其实很简单,它指明了该字符串是否需要被复制。 值为 1 将先申请一块新内存并赋值该字符串,然后把新内存的地址复制给pzv, 为 0 时则是直接把str的地址赋值给zval。
《抚琴居》上的一篇文章说这项特性将会在你仅仅需要创建一个变量并将其指向一个已经由 Zend 内部数据内存时变得很有用。
### ZVAL\_STRINGL与ZVAL\_STRING的区别
如果你想在某一位置截取该字符串或已经知道了这个字符串的长度, 那么可以使用宏 ZVAL\_STRINGL(zval, string, length, duplicate) ,它显式的指定字符串长度, 而不是使用strlen()。这个宏该字符串长度作为参数。但它是二进制安全的,而且速度也比ZVAL\_STRING快,因为少了个strlen。
### ZVAL\_RESOURCE约等于ZVAL\_LONG
上一节中我们说过PHP中的资源类型的值其实就是一个整数,所以ZVAL\_RESOURCE和ZVAL\_LONG的工作差不多, 只不过它会把zval的类型设置为 IS\_RESOURCE。
## links
- [目录](preface.md)
- 2.2 [变量的值](2.2.html)
- 2.4 [变量的存储方式](2.4.html)
- 介绍
- 1 PHP的生命周期
- 1.1 让我们从SAPI开始
- 1.2 PHP的启动与终止
- 1.3 PHP的生命周期
- 1.4 线程安全
- 1.5 PHP的生命周期
- 2 PHP变量在内核中的实现
- 2.1 变量的类型
- 2.2 变量的值
- 2.3 创建PHP变量
- 2.4 变量的存储方式
- 2.5 变量的检索
- 2.6 类型转换
- 2.7 小结
- 3 内存管理
- 3.1 内存管理
- 3.2 引用计数
- 3.3 内存管理
- 4 动手编译PHP
- 4.1 动手编译PHP
- 4.2 动手编译PHP
- 4.3 Unix/Linux平台下的编译
- 4.4 在Win32平台上编译PHP
- 4.5 动手编译PHP
- 5 Your First Extension
- 5.1 Your First Extension
- 5.2 编译我们的扩展
- 5.3 静态编译
- 5.4 编写函数
- 5.5 Your First Extension
- 6 函数返回值
- 6.1 函数返回值
- 6.2 引用与函数的执行结果
- 6.3 函数返回值
- 7 函数的参数
- 7.1 函数的参数
- 7.2 函数的参数
- 7.3 函数的参数
- 8 使用HashTable与{数组}
- 8.1 使用HashTable与{数组}
- 8.2 使用HashTable与{数组}
- 8.3 使用HashTable与{数组}
- 8.4 使用HashTable与{数组}
- 9 PHP中的资源类型
- 9.1 PHP中的资源类型
- 9.2 PHP中的资源类型
- 9.3 PHP中的资源类型
- 9.4 PHP中的资源类型
- 10 PHP中的面向对象(一)
- 10.1 PHP中的面向对象(一)
- 10.2 PHP中的面向对象(一)
- 10.3 PHP中的面向对象(一)
- 10.4 PHP中的面向对象(一)
- 10.5 PHP中的面向对象(一)
- 11 PHP中的面向对象(二)
- 11.1 PHP中的面向对象(二)
- 11.2 PHP中的面向对象(二)
- 11.3 PHP中的面向对象(二)
- 12 启动与终止的那点事
- 12.1 关于生命周期
- 12.2 MINFO与phpinfo
- 12.3 常量
- 12.4 PHP扩展中的全局变量
- 12.5 PHP语言中的超级全局变量(Superglobals)
- 12.6 小结
- 13 INI设置
- 13.1 声明和访问INI设置
- 13.2 小结
- 14 流式访问
- 14.1 流的概览
- 14.2 访问流
- 14.3 静态资源操作
- 14.4 links
- 15 流的实现
- 15.1 php流的表象之下
- 15.2 包装器操作
- 15.3 实现一个包装器
- 15.4 操纵
- 15.5 检查
- 15.6 小结
- 16 有趣的流
- 16.1 上下文
- 16.2 过滤器
- 16.3 小结
- 17 配置和链接
- 17.1 autoconf
- 17.2 库的查找
- 17.3 强制模块依赖
- 17.4 Windows方言
- 17.5 小结
- 18 扩展生成
- 18.1 ext_skel
- 18.2 PECL_Gen
- 18.3 小结
- 19 设置宿主环境
- 19.1 嵌入式SAPI
- 19.2 构建并编译一个宿主应用
- 19.3 通过嵌入包装重新创建cli
- 19.4 老技术新用
- 19.5 小结
- 20 高级嵌入式
- 20.1 回调到php中
- 20.2 错误处理
- 20.3 初始化php
- 20.4 覆写INI_SYSTEM和INI_PERDIR选项
- 20.5 捕获输出
- 20.6 同时扩展和嵌入
- 20.7 小结