# 7.2 函數的參數
在前面的章節中我們已經介紹過arg info了,下面我們看一下如何通過其實現類型綁定,但這個特性只能在Zend Engine 2也就是PHP5中使用。
讓我們再回顧一下ZE2's argument info結構。每一個arg info結構的聲明都是通過ZEND_BEGIN_ARG_INFO()或者ZEND_BEGIN_ARG_INFO_EX()宏函數開始的,然后緊跟著幾行ZEND_ARG_*INFO()宏函數,最終以ZEND_END_ARG_INFO()宏函數結束。每個宏的基本作用我們可以在第6章的最后一節看到。如果我們想重寫一下PHP語言中的count()函數,可以:
````c
ZEND_FUNCTION(sample_count_array)
{
zval *arr;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a",&arr) == FAILURE)
{
RETURN_NULL();
}
RETURN_LONG(zend_hash_num_elements(Z_ARRVAL_P(arr)));
}
````
zend_parse_parameters()本身可以保證傳遞過來的參數是一個數組。但是如果我們通過zend_get_parameter()函數來接收參數的話就沒這么幸運了,需要我們自己進行類型校對。如果想讓內核自動完成類型校對,便需要arg_info上場了:
````c
ZEND_BEGIN_ARG_INFO(php_sample_array_arginfo, 0)
ZEND_ARG_ARRAY_INFO(0, arr, 0)
ZEND_END_ARG_INFO()
....
PHP_FE(sample_count_array, php_sample_array_arginfo)
....
````
這樣我們便把類型校對的工作交給了Zend Engine,是不是有種如釋重負的感覺!You've also given your argument a name so that the generated error messages can be more meaningful to script writers attempting to use your API.
我們同樣可以對參數中的對象進行校驗,限制其是繼承自某個類或者實現了某個接口等等。
````c
ZEND_BEGIN_ARG_INFO(php_sample_class_arginfo, 0)
ZEND_ARG_OBJ_INFO(1, obj, stdClass, 0)
ZEND_END_ARG_INFO()
````
需要注意的是,此時第一個參數的值是數字1,代表著以引用的方式傳遞。其實這個參數對于對象來說幾乎沒用,因為ZE2中所有的對象在當作函數參數的時候都是默認以引用的形式傳遞的。但是我們又必須把這個參數設置為數字1,除非你不想讓你的擴展與PHP4兼容。在PHP4中,對象是傳遞的一個完整Copy,而非通過引用。
對于數組和對象參數,不要忘記最后的允許為NULL的參數。更多的信息請參考第6章最后一節的有關敘述。
通過arg info的方式來實現類型綁定的功能只對ZE2有效,也就是PHP5+。如果你想在PHP4上實現相應的功能,那需要用 zend_get_parameters()函數來接收參數,然后通過Z_TYPE_P()宏函數來檢測參數的類型或者通過convert_to_type()函數進行類型轉換。
## links
* 7.1 [zend_parse_parameters](<7.1.md>)
* 7.3 [第七章小結](<7.3.md>)
- about
- 開始閱讀
- 目錄
- 1 PHP的生命周期
- 1.讓我們從SAPI開始
- 2.PHP的啟動與終止
- 3.PHP的生命周期
- 4.線程安全
- 5.小結
- 2 PHP變量在內核中的實現
- 1. 變量的類型
- 2. 變量的值
- 3. 創建PHP變量
- 4. 變量的存儲方式
- 5. 變量的檢索
- 6. 類型轉換
- 7. 小結
- 3 內存管理
- 1. 內存管理
- 2. 引用計數
- 3. 總結
- 4 動手編譯PHP
- 1. 編譯前的準備
- 2. PHP編譯前的config配置
- 3. Unix/Linux平臺下的編譯
- 4. 在Win32平臺上編譯PHP
- 5. 小結
- 5 Your First Extension
- 1. 一個擴展的基本結構
- 2. 編譯我們的擴展
- 3. 靜態編譯
- 4. 編寫函數
- 5. 小結
- 6 函數返回值
- 1. 一個特殊的參數:return_value
- 2. 引用與函數的執行結果
- 3. 小結
- 7 函數的參數
- 1. zend_parse_parameters
- 2. Arg Info 與類型綁定
- 3. 小結
- 8 使用HashTable與{數組}
- 1. 數組(C中的)與鏈表
- 2. 操作HashTable的API
- 3. 在內核中操作PHP語言中數組
- 4. 小結
- 9 PHP中的資源類型
- 1. 復合類型的數據——{資源}
- 2. Persistent Resources
- 3. {資源}自有的引用計數
- 4. 小結
- 10 PHP中的面向對象(一)
- 1. zend_class_entry
- 2. 定義一個類
- 3. 定義一個接口
- 4. 類的繼承與接口的實現
- 5. 小結
- 11 PHP中的面向對象(二)
- 1. 生成對象的實例與調用方法
- 2. 讀寫對象的屬性
- 3. 小結
- 12 啟動與終止的那點事
- 2. 小結
- 1. 關于生命周期
- 2. MINFO與phpinfo
- 3. 常量
- 4. PHP擴展中的全局變量
- 5. PHP語言中的超級全局變量
- 6. 小結
- 13 INI設置
- 1. 聲明和訪問ini設置
- 2. 小結
- 2. 小結
- 14 流式訪問
- 1. 概覽
- 2. 打開流
- 3. 訪問流
- 4. 靜態資源操作
- 5. 小結
- 15 流的實現
- 1. php流的表象之下
- 2. 包裝器操作
- 3. 實現一個包裝器
- 4. 操縱
- 5. 檢查
- 6. 小結
- 16 有趣的流
- 1. 上下文
- 2. 過濾器
- 3. 小結
- 17 配置和鏈接
- 1. autoconf
- 2. 庫的查找
- 3. 強制模塊依賴
- 4. Windows方言
- 5. 小結
- 18 擴展生成
- 1. ext_skel
- 2. PECL_Gen
- 3. 小結
- 19 設置宿主環境
- 1. 嵌入式SAPI
- 2. 構建并編譯一個宿主應用
- 3. 通過嵌入包裝重新創建cli
- 4. 老技術新用
- 5. 小結
- 20 高級嵌入式
- 1. 回調到php中
- 2. 錯誤處理
- 3. 初始化php
- 4. 覆寫INI_SYSTEM和INI_PERDIR選項
- 5. 捕獲輸出
- 6. 同時擴展和嵌入
- 7. 小結
- 約定