PHP7擴展開發之創建變量

前言

在這篇博文中我們將演示如何在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擴展源碼：

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
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文件中，宏方法以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的變量名，使用此方法創建本地變量

更多PHP相關技術請搜索千鋒PHP，做真實的自己，用良心做教育