科技幫的部落格

#前言

在這篇博文中我們將演示如何在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代碼中調用這個方法，看下效果。

<?phpclass 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的變數名，使用此方法創建本地變數。