前言
這次,我們將演示如何在PHP擴(kuò)展中接受傳入的參數(shù)和輸出返回值。
<?php function default_value ($type, $value = null) { if ($type == "int") { return $value ?? 0; } else if ($type == "bool") { return $value ?? false; } else if ($type == "str") { return is_null($value) ? "" : $value; } return null; } var_dump(default_value("int")); var_dump(default_value("int", 1)); var_dump(default_value("bool")); var_dump(default_value("bool", true)); var_dump(default_value("str")); var_dump(default_value("str", "a")); var_dump(default_value("array")); ?>
我們將在擴(kuò)展中實(shí)現(xiàn)default_value
方法?!就扑]:《PHP7教程》】
代碼
實(shí)現(xiàn)default_value方法
default_value
方法的PHP擴(kuò)展源碼:
PHP_FUNCTION(default_value) { zend_string *type; zval *value = NULL; #ifndef FAST_ZPP /* Get function parameters and do error-checking. */ if (zend_parse_parameters(ZEND_NUM_ARGS(), "S|z", &type, &value) == FAILURE) { return; } #else ZEND_PARSE_PARAMETERS_START(1, 2) Z_PARAM_STR(type) Z_PARAM_OPTIONAL Z_PARAM_ZVAL_EX(value, 0, 1) ZEND_PARSE_PARAMETERS_END(); #endif if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "int", 3) == 0 && value == NULL) { RETURN_LONG(0); } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "int", 3) == 0 && value != NULL) { RETURN_ZVAL(value, 0, 1); } else if (ZSTR_LEN(type) == 4 && strncmp(ZSTR_VAL(type), "bool", 4) == 0 && value == NULL) { RETURN_FALSE; } else if (ZSTR_LEN(type) == 4 && strncmp(ZSTR_VAL(type), "bool", 4) == 0 && value != NULL) { RETURN_ZVAL(value, 0, 1); } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "str", 3) == 0 && value == NULL) { RETURN_EMPTY_STRING(); } else if (ZSTR_LEN(type) == 3 && strncmp(ZSTR_VAL(type), "str", 3) == 0 && value != NULL) { RETURN_ZVAL(value, 0, 1); } RETURN_NULL(); }
代碼說(shuō)明
獲取參數(shù)
在PHP7中提供了兩種獲取參數(shù)的方法。zend_parse_parameters
和FAST ZPP方式。
zend_parse_parameters
在PHP7之前一直使用zend_parse_parameters
函數(shù)獲取參數(shù)。這個(gè)函數(shù)的作用,就是把傳入的參數(shù)轉(zhuǎn)換為PHP內(nèi)核中相應(yīng)的類型,方便在PHP擴(kuò)展中使用。
參數(shù)說(shuō)明:
第一個(gè)參數(shù),參數(shù)個(gè)數(shù)。一般就使用ZEND_NUM_ARGS(),不需要改變。
第二個(gè)參數(shù),格式化字符串。這個(gè)格式化字符串的作用就是,指定傳入?yún)?shù)與PHP內(nèi)核類型的轉(zhuǎn)換關(guān)系。
代碼中 S|z 的含義就是:
S 表示參數(shù)是一個(gè)字符串。要把傳入的參數(shù)轉(zhuǎn)換為zend_string類型。
| 表示之后的參數(shù)是可選??梢詡?,也可以不傳。
z 表示參數(shù)是多種類型。要把傳入的參數(shù)轉(zhuǎn)換為zval類型。
除此之外,還有一些specifier,需要注意:
!如果接收了一個(gè)PHP語(yǔ)言里的null變量,則直接把其轉(zhuǎn)成C語(yǔ)言里的NULL,而不是封裝成IS_NULL類型的zval。
/ 如果傳遞過(guò)來(lái)的變量與別的變量共用一個(gè)zval,而且不是引用,則進(jìn)行強(qiáng)制分離,新的zval的is_ref__gc==0, and refcount__gc==1.