php入門到就業(yè)線上直播課:進入學(xué)習(xí)
Apipost = Postman + Swagger + Mock + Jmeter 超好用的API調(diào)試工具:點擊使用
年前花了點時間,對Yar的性能做了一些做了一些提升,但是也遇到一個讓我有點不舒服的當(dāng)初沒有良好設(shè)計遺留的問題,就是在并行調(diào)用RPC的時候,現(xiàn)在的方法原型是:
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 {}
是不是一看就很頭大?
因為在實際的使用過程中,很有可能回調(diào)函數(shù)和錯誤回調(diào)函數(shù)是空的,因為可以真正發(fā)起調(diào)用的時候,也就是在loop重全局指定:
Yar_Concurrent_Client::loop(?callable $callback = NULL, ?callable $error_callback = NULL, ?array $options = NULL):?bool {}
而很多時候$options是有用的,根據(jù)調(diào)用相關(guān),所以就導(dǎo)致,實際的使用的時候,大量的并行調(diào)用的代碼會在參數(shù)中寫很多的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"));
于是我一直想如何能讓這樣的調(diào)用更優(yōu)雅一些,曾經(jīng)一度我想使用多態(tài),或者新增一個API,類似:
public static Yar_Concurrent_Client::callArray(array $arguments):null|int|bool {}
但強迫癥讓我覺得這樣做,遺禍無窮, 今天早上我突然想起以前曾經(jīng)看到過的一個RFC,于是找了半天,發(fā)現(xiàn)早在PHP5.6的時候,就commit了, 但反正我比較老派,新特性研究的少,也是沒怎么用過,就不知道大家是否會用過了。 ?
就是今天要介紹的第一個特性:Argument unpacking。
Argument unpacking
我們知道PHP支持可變參數(shù),也就是variadic function. 比如對于如下的函數(shù)定義:
function variadic(...$arguments) { var_dump($arguments); }
注意參數(shù)的定義,使用了三個點…(ellipsis符號), 意思就是無論你在調(diào)用這個函數(shù)的時候傳遞了多少個參數(shù),這些參數(shù)都會被打包成一個名字為$arguments的數(shù)組:
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" }
當(dāng)然,這個不是我們今天要用到的,這個特性還有一個對應(yīng)的在調(diào)用時刻使用的兄弟形式,叫做argument unpacking:
比如,類似上面我的那個問題,我們定義了一個函數(shù)
function dummy($a, $b = NULL, $c = NULL, $d = NULL, $e = NULL) { var_dump($a, $b, $c, $d, $e); }
如果大部分情況下我們的參數(shù)b, c, d都是NULL, 但是e可能需要傳遞,那我們就可以使用argument unpacking來避免代碼中大量的NULL參數(shù),類似:
$arguments = array( "First argument", NULL, NULL, NULL, "Fifth argument", ); dummy(...$arguments); //output: // string(14) "First argument" // NULL // NULL // NULL // string(14) "Fifth argument"
注意在調(diào)用的時候,我也使用了…,這里的意思就是,把…后面的數(shù)組解開,按照順序分別依次傳遞給被調(diào)用的函數(shù),第一個元素對應(yīng)第一個參數(shù), 第二個對應(yīng)第二個。
但是注意,這里的位置是跟填充位置相關(guān)的,跟索引無關(guān),也就是說:
$arguments = array( 4=> "First argument", 0=> "Fifth argument" ),
這樣的形式, 索引4依然是被認(rèn)為是第一個參數(shù)。
想到這個以后,我就突然發(fā)現(xiàn),我不需要給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);
你以為這就完了么?
考慮到如上的代碼,還是有一個問題,就是需要構(gòu)造一個中間數(shù)組,對于強迫癥的我們來說,總還是覺得會有點,那啥…
但其實我們還可以利用PHP8.0中引入的另外一個RFC, Named parameter:
Named Parameter
在PHP8.0以后,容許用戶在傳遞參數(shù)的時候,指定參數(shù)名字, 比如還是對于上面的例子函數(shù):
function dummy($a, $b = NULL, $c = NULL, $d = NULL, $e = NULL) { var_dump($a, $b, $c, $d, $e); }
現(xiàn)在我們可以在調(diào)用的時候,指定要傳遞的參數(shù)名字,比如:
dummy(a:"dummy", e:"foo"); //output: // string(5) "dummy" // NULL // NULL // NULL // string(3) "foo"
也就是說,我指定了傳遞給a和e參數(shù),沒有指定的就是默認(rèn)缺省值,你甚至可以不按聲明順序來,比如:
dummy(e:"foo", a:"dummy");
輸出結(jié)果也是一樣的。
這樣以來,開頭的代碼就可以變成:
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")));
你就可以在調(diào)用的時候,想傳那個傳那個,想怎么傳就怎么傳
雖然代碼相比argument unpacking還是有點長,但是既解決了不用寫那么多NULL,又不會引入新的中間變量。
于是,問題完美解決,我也不用引入新的API了 :)
原文地址:https://www.laruence.com/2022/05/10/6192.html
推薦學(xué)習(xí):《PHP視頻教程》