編寫PHP擴充函數的參數類型綁定

來源:互聯網
上載者:User
我們看一下如何通過其實作類別型綁定,但這個特性只能在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()宏函數結束。如果我們想重寫一下PHP語言中的count()函數,可以:
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上場了:
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. 我們同樣可以對參數中的對象進行校正,限制其是繼承自某個類或者實現了某個介面等等。
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,而非通過引用。

<div class="tip-common">對於數組和對象參數,不要忘記最後的允許為NULL的參數。更多的資訊請參考第6章最後一節的有關敘述。</code>
通過arg info的方式來實作類別型綁定的功能只對ZE2有效,也就是PHP5+。如果你想在PHP4上實現相應的功能,那需要用 zend_get_parameters()函數來接收參數,然後通過Z_TYPE_P()宏函數來檢測參數的類型或者通過convert_to_type()函數進行類型轉換。
  • 聯繫我們

    該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

    如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。

    A Free Trial That Lets You Build Big!

    Start building with 50+ products and up to 12 months usage for Elastic Compute Service

    • Sales Support

      1 on 1 presale consultation

    • After-Sales Support

      24/7 Technical Support 6 Free Tickets per Quarter Faster Response

    • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.