3. 創建PHP變量 · 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的類型和值。 <table> <tr> <td>新宏</td> <td>其它宏的實現方法</td> </tr> <tr> <td>ZVAL_NULL(pvz); **(注意這個Z和VAL之間沒有下劃線！)**</td> <td>Z_TYPE_P(pzv) = IS_NULL;**(IS_NULL型不用賦值，因為這個類型只有一個值就是null，^_^)**</td> </tr> <tr> <td>ZVAL_BOOL(pzv, b); **(將pzv所指的zval設置為IS_BOOL類型，值是b)**</td> <td> Z_TYPE_P(pzv) = IS_BOOL; Z_BVAL_P(pzv) = b ? 1 : 0; </td> </tr> <tr> <td>ZVAL_TRUE(pzv); **(將pzv所指的zval設置為IS_BOOL類型，值是true)**</td> <td>ZVAL_BOOL(pzv, 1);</td> </tr> <tr> <td>ZVAL_FALSE(pzv); **(將pzv所指的zval設置為IS_BOOL類型，值是false)**</td> <td>ZVAL_BOOL(pzv, 0);</td> </tr> <tr> <td>ZVAL_LONG(pzv, l); **(將pzv所指的zval設置為IS_LONG類型，值是l)**</td> <td>Z_TYPE_P(pzv) = IS_LONG;<br />Z_LVAL_P(pzv) = l;</td> </tr> <tr> <td>ZVAL_DOUBLE(pzv, d); **(將pzv所指的zval設置為IS_DOUBLE類型，值是d)**</td> <td>Z_TYPE_P(pzv) = IS_DOUBLE;<br />Z_DVAL_P(pzv) = d;</td> </tr> <tr> <td>ZVAL_STRINGL(pzv,str,len,dup);**(下面單獨解釋)**</td> <td>Z_TYPE_P(pzv) = IS_STRING;<br />Z_STRLEN_P(pzv) = len;<br />if (dup) <br />{Z_STRVAL_P(pzv) =estrndup(str, len + 1);} <br />else<br /> {Z_STRVAL_P(pzv) = str;}</td> </tr> <tr> <td>ZVAL_STRING(pzv, str, dup);</td> <td>ZVAL_STRINGL(pzv, str,strlen(str), dup);</td> </tr> <tr> <td>ZVAL_RESOURCE(pzv, res);</td> <td>Z_TYPE_P(pzv) = IS_RESOURCE;<br />Z_RESVAL_P(pzv) = res;</td> </tr> </table> ### 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.md>) * 2.4 [變量的存儲方式](<2.4.md>)