## 前言
在这篇博文中我们将演示如何在PHP扩展中创建一个变量。示例代码如下:
```php
<?php
class demo {}
$lng = 2;
$str = "abc";
$arr = array(1,'a' => 'b');
$obj = new demo();
var_dump($str);
var_dump($arr);
var_dump($obj);
?>
```
中间的三行我们将用PHP扩展来实现。
## 代码
### 基础代码
这个扩展,我们将在say扩展上增加 `define_var` 方法。say扩展相关代码大家请看这篇博文。PHP7扩展开发之hello word 文中已经详细介绍了如何创建一个扩展和提供了源码下载。
### 实现define_var方法
define_var方法的PHP扩展源码:
```c
PHP_FUNCTION(define_var)
{
zval var_value; //变量的值
zend_string *var_name = NULL; //变量名称
//创建整型变量
ZVAL_LONG(&var_value, 2);
zend_set_local_var_str("lng", 3 , &var_value, 0); //设置本地变量
ZVAL_NULL(&var_value);
//创建字符串变量
zend_string *str = NULL;
char content[4] = "abc";
var_name = zend_string_init("str", 3, 0); //设置变量名称
str = zend_string_init(content, sizeof(content) - 1, 0);
ZVAL_STR(&var_value, str); //设置变量的值
zend_set_local_var(var_name, &var_value, 0); //设置本地变量
zend_string_release(var_name);
ZVAL_NULL(&var_value);
//创建数组变量
var_name = zend_string_init("arr", 3, 0); //设置变量名称
array_init(&var_value);
add_index_long(&var_value, 0, 1);
add_assoc_stringl_ex(&var_value, "a", 1, "b", 1);
zend_set_local_var(var_name, &var_value, 0); //设置本地变量
zend_string_release(var_name);
ZVAL_NULL(&var_value);
//创建对象变量
zend_class_entry *ce;
zend_string *class_name;
class_name = zend_string_init("demo", 4, 0);
ce = zend_fetch_class(class_name, ZEND_FETCH_CLASS_AUTO); //获取类
zend_string_release(class_name);
object_init_ex(&var_value, ce);
zend_set_local_var_str("obj", 3, &var_value, 0); //设置本地变量
ZVAL_NULL(&var_value);
}
```
现在,我们在PHP代码中调用这个方法,看下效果。
```php
<?php
class demo {}
define_var();
var_dump($str);
var_dump($arr);
var_dump($obj);
?>
```
执行效果如下:
```
$ php ./test.php
int(2)
string(3) "abc"
array(2) {
[0]=>
int(1)
["a"]=>
string(1) "b"
}
object(demo)#1 (0) {
}
```
## 代码解读
注意,下面的内容,我们把PHP扩展中的zval结构成为变量,把PHP代码中的变量成为本地变量。
创建本地变量主要分两步,创建变量和设置为本地变量。
### 创建变量
变量的类型有多种,在创建变量的方式也有所不同。
对于简单的数据类型,创建变量很简单。只需调用相应的宏方法就可以。
这些方法在[Zend/zend_types.h](https://github.com/php/php-src/blob/master/Zend/zend_types.h)文件中,宏方法以`ZVAL_`开头。如:
```
ZVAL_NULL 设置为null
ZVAL_FALSE 设置为false。
ZVAL_TRUE 设置为true
ZVAL_BOOL 设置bool。
ZVAL_LONG 设置long。
ZVAL_DOUBLE 设置为double。
```
使用方法,可以参考上面代码中`ZVAL_LONG`的调用。
对于数组,对象,字符串等复杂数据类型。比较麻烦。可以参考上面的示例代码。
### 设置本地变量
设置本地变量Zend引擎为我们提供了两个方法。两个函数的使用,都在以上的代码中做了演示。这两个方法的应用场景有所差别。
**zend_set_local_var**
如果已经存在类型为`zend_string`的变量名,则使用这个方法创建本地变量
**zend_set_local_var_str**
如果没有类型为`zend_string`的变量名,使用此方法创建本地变量