淺析PHP8.0特性:Named Parameter(命名參數)

青灯夜游
發布: 2023-04-11 08:44:01
轉載
1917 人瀏覽過

淺析PHP8.0特性:Named Parameter(命名參數)

年前花了點時間,對Yar的性能做了一些做了一些提升,但是也遇到一個讓我有點不舒服的當初沒有良好設計遺留的問題,就是在並行呼叫RPC的時候,現在的方法原型是:

public static Yar_Concurrent_Client::call(string $uri, string $method, ?array $arguments = NULL, ?callable $callback = NULL, ?callable $error_callback = NULL, ?array $options = NULL):null|int|bool {}
登入後複製

是不是一看就很頭大?

因為在實際的使用過程中,很有可能回呼函數和錯誤回呼函數是空的,因為可以真正發起呼叫的時候,也就是在loop重全域指定:

Yar_Concurrent_Client::loop(?callable $callback = NULL, ?callable $error_callback = NULL, ?array $options = NULL):?bool {}
登入後複製

而很多時候$options是有用的,根據呼叫相關,所以就導致,實際的使用的時候,大量的並行調用的程式碼會在參數中寫很多的NULL, 類似:

Yar_Concurrent_Clinet::call("https://xxx.com/api", "method", array("arguments"), NULL, NULL, array(YAR_OPT_HEADER=>array("header:val1"));
Yar_Concurrent_Clinet::call("https://xxx.com/api", "method", array("arguments"), NULL, NULL, array(YAR_OPT_HEADER=>array("header:val2"));
Yar_Concurrent_Clinet::call("https://xxx.com/api", "method", array("arguments"), NULL, NULL, array(YAR_OPT_HEADER=>array("header:val2"));
Yar_Concurrent_Clinet::call("https://xxx.com/api", "method", array("arguments"), NULL, NULL, array(YAR_OPT_HEADER=>array("header:val4"));
登入後複製

於是我一直想如何能讓這樣的呼叫更優雅一些,曾經一度我想使用多態,或者新增一個API,類似:

public static Yar_Concurrent_Client::callArray(array $arguments):null|int|bool {}
登入後複製

但強迫症讓我覺得這樣做,遺禍無窮, 今天早上我突然想起以前曾經看到過的一個RFC,於是找了半天,發現早在PHP5.6的時候,就commit了, 但反正我比較老派,新特性研究的少,也是沒怎麼用過,就不知道大家是否會用過了。 ?

就是今天要介紹的第一個特性:Argument unpacking。

Argument unpacking

我們知道PHP支援可變參數,也就是variadic function. 例如對於如下的函數定義:

function variadic(...$arguments) {
    var_dump($arguments);
}
登入後複製

注意參數的定義,使用了三個點…(ellipsis符號), 意思就是無論你在呼叫這個函數的時候傳遞了多少個參數,這些參數都會被打包成一個名字為$arguments的數組:

variadic();
//output: array(0) { }
variadic(NULL);
//output: array(1) { [0]=> NULL }
variadic("foo", "bar");
//output: array(2) { [0]=> string(3) "foo"  [1]=> string(3) "bar" }
variadic(NULL, array(), "dummy");
//output: array(3) { [0]=> NULL [1]=>[] [2]=> string(5) "dummy" }
登入後複製

當然,這個不是我們今天要用到的,這個特性還有一個對應的在呼叫時刻使用的兄弟形式,叫做argument unpacking:

比如,類似上面我的那個問題,我們定義了一個函數

function dummy($a, $b = NULL, $c = NULL, $d = NULL, $e = NULL) {
    var_dump($a, $b, $c, $d, $e);
}
登入後複製
登入後複製

如果大部分情況下我們的參數b, c,  d都是NULL, 但是e可能需要傳遞,那我們就可以使用argument unpacking來避免程式碼中大量的NULL參數,類似:

$arguments = array(
    "First argument",
    NULL,  NULL,  NULL,
    "Fifth argument",
);
 
dummy(...$arguments);
 
//output:
// string(14) "First argument"
// NULL
// NULL
// NULL
// string(14) "Fifth argument"
登入後複製

注意在呼叫的時候,我也使用了…,這裡​​的意思就是,把…後面的數組解開,按照順序分別依次傳遞給被調用的函數,第一個元素對應第一個參數, 第二個對應第二個。

但是注意,這裡的位置是跟填充位置相關的,跟索引無關,也就是說:

$arguments = array(
    4=> "First argument",
    0=> "Fifth argument"
),
登入後複製

這樣的形式, 索引4依然是被認為是第一個參數。

想到這個以後,我就突然發現,我不需要給Yar引入新東西了,最開的例子就可以變成:

$arguments = array(
    "https://xxx.com/api",
    "method",
    array("arguments"),
    NULL, NULL, 
    "options" => array(YAR_OPT_HEADER => array("header:val1")
)
Yar_Concurrent_Clinet::call(...$arguments);
 
$arguments["options"][YAR_OPT_HADER] = ["header:val2"];
Yar_Concurrent_Clinet::call(...$arguments);
 
$arguments["options"][YAR_OPT_HADER] = ["header:val3"];
Yar_Concurrent_Clinet::call(...$arguments);
 
$arguments["options"][YAR_OPT_HADER] = ["header:val4"];
Yar_Concurrent_Clinet::call(...$arguments);
Yar_Concurrent_Clinet::call(...$arguments);
登入後複製

你以為這就完了麼?

考慮到如上的程式碼,還是有一個問題,就是需要建構一個中間數組,對於強迫症的我們來說,總還是覺得會有點,那啥…

#但其實我們還可以利用PHP8.0引入的另外一個RFC, Named parameter:

Named Parameter

在PHP8.0以後,容許用戶在傳遞參數的時候,指定參數名字, 例如還是對於上面的例子函數:

function dummy($a, $b = NULL, $c = NULL, $d = NULL, $e = NULL) {
    var_dump($a, $b, $c, $d, $e);
}
登入後複製
登入後複製

現在我們可以在呼叫的時候,指定要傳遞的參數名字,例如:

dummy(a:"dummy", e:"foo");
//output:
// string(5) "dummy"
// NULL
// NULL
// NULL
// string(3) "foo"
登入後複製

也就是說,我指定了傳遞給a和e參數,沒有指定的就是預設預設值,你甚至可以不依照宣告順序來,例如:

dummy(e:"foo", a:"dummy");
登入後複製

輸出結果也是一樣的。

這樣以來,開頭的程式碼就可以變成:

Yar_Concurrent_Client::call("https://xxx.com/api", "method", arguments:array("arguments"), options:array(YAR_OPT_HEADER=>array("header:val1")));
Yar_Concurrent_Client::call("https://xxx.com/api", "method", arguments:array("arguments"), options:array(YAR_OPT_HEADER=>array("header:val2")));
Yar_Concurrent_Client::call("https://xxx.com/api", "method", arguments:array("arguments"), options:array(YAR_OPT_HEADER=>array("header:val3")));
Yar_Concurrent_Client::call("https://xxx.com/api", "method", arguments:array("arguments"), options:array(YAR_OPT_HEADER=>array("header:val4")));
登入後複製

你就可以在呼叫的時候,想傳那個傳那個,想怎麼傳就怎麼傳

#雖然程式碼相比argument unpacking還是有點長,但既解決了不用寫那麼多NULL,又不會引入新的中間變數。

於是,問題完美解決,我也不用引入新的API了:)

#原文網址:https://www.laruence.com/2022/05/10/ 6192.html

推薦學習:《PHP影片教學

以上是淺析PHP8.0特性:Named Parameter(命名參數)的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
php
來源:laruence.com
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板