## 前言
這次,我們將演示如何在PHP擴展中接受傳入的參數和輸出返回值。
```php
<?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"));
?>
```
我們將在擴展中實現`default_value`方法。
## 代碼
### 基礎代碼
這個擴展,我們將在`say`擴展上增加 `default_value` 方法。`say`擴展相關代碼大家請看這篇博文。[PHP7擴展開發之hello word](http://www.hmoore.net/lifei6671/php-extention-dev/672583) 文中已經詳細介紹了如何創建一個擴展和提供了源碼下載。
### 實現default_value方法
`default_value`方法的PHP擴展源碼:
```c
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();
}
```
## 代碼說明
### 獲取參數
在PHP7中提供了兩種獲取參數的方法。`zend_parse_parameters`和`FAST ZPP`方式。
**zend_parse_parameters**
在PHP7之前一直使用`zend_parse_parameters`函數獲取參數。這個函數的作用,就是把傳入的參數轉換為PHP內核中相應的類型,方便在PHP擴展中使用。
**參數說明:**
第一個參數,參數個數。一般就使用`ZEND_NUM_ARGS()`,不需要改變。
第二個參數,格式化字符串。這個格式化字符串的作用就是,指定傳入參數與PHP內核類型的轉換關系。
代碼中 S|z 的含義就是:
`S `表示參數是一個字符串。要把傳入的參數轉換為zend_string類型。
`|` 表示之后的參數是可選。可以傳,也可以不傳。
`z` 表示參數是多種類型。要把傳入的參數轉換為zval類型。
除此之外,還有一些specifier,需要注意:
`!`如果接收了一個PHP語言里的null變量,則直接把其轉成C語言里的NULL,而不是封裝成`IS_NULL`類型的zval。
`/` 如果傳遞過來的變量與別的變量共用一個`zval`,而且不是引用,則進行強制分離,新的zval的`is_ref__gc==0, and refcount__gc==1`.
更多格式化字符串的含義可以查看官方網站。https://wiki.php.net/rfc/fast_zpp
**FAST ZPP**
在PHP7中新提供的方式。是為了提高參數解析的性能。對應經常使用的方法,建議使用`FAST ZPP`方式。
使用方式:
以`ZEND_PARSE_PARAMETERS_START(1, 2)`開頭。
第一個參數表示必傳的參數個數,第二個參數表示最多傳入的參數個數。
以`ZEND_PARSE_PARAMETERS_END();`結束。
中間是傳入參數的解析。
值得注意的是,一般`FAST ZPP`的宏方法與`zend_parse_parameters`的specifier是一一對應的。如:
`Z_PARAM_OPTIONAL` 對應` |`
`Z_PARAM_STR` 對應 `S`
但是,`Z_PARAM_ZVAL_EX`方法比較特殊。它對應兩個specifier,分別是` !` 和 `/` 。`!` 對應宏方法的第二個參數。`/` 對應宏方法的第三個參數。如果想開啟,只要設置為1即可。
FAST ZPP相應的宏方法可以查看官方網站 https://wiki.php.net/rfc/fast_zpp#proposal
### 返回值
方法的返回值是使用`RETURN_`開頭的宏方法進行返回的。常用的宏方法有:
* `RETURN_NULL()` 返回null
* `RETURN_LONG(l)` 返回整型
* `RETURN_DOUBLE(d)` 返回浮點型
* `RETURN_STR(s)` 返回一個字符串。參數是一個zend_string * 指針
* `RETURN_STRING(s)` 返回一個字符串。參數是一個char * 指針
* `RETURN_STRINGL(s, l)` 返回一個字符串。第二個參數是字符串長度。
* `RETURN_EMPTY_STRING()` 返回一個空字符串。
* `RETURN_ARR(r)` 返回一個數組。參數是zend_array *指針。
* `RETURN_OBJ(r)` 返回一個對象。參數是zend_object *指針。
* `RETURN_ZVAL(zv, copy, dtor)` 返回任意類型。參數是 zval *指針。
* `RETURN_FALSE `返回false
* `RETURN_TRUE` 返回true
更多宏方法請查看 Zend/zend_API.h中的相關代碼。
[更多函數說明請查看](https://www.bo56.com/php7%E6%BA%90%E7%A0%81%E9%98%85%E8%AF%BB%E7%AC%94%E8%AE%B0%EF%BC%88%E4%B8%8D%E6%96%AD%E6%9B%B4%E6%96%B0%EF%BC%89/)