## 前言
在這篇博文中我們將演示如何在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`的變量名,使用此方法創建本地變量