PHP 8.0新功能:Match表达式

上个月下旬PHP社区发布是PHP8第一个,正式版本也将于今年年底发布。PHP8带来来那个两个最令人激动的特性:JIT和match表达式。

本文我们要说另一个新引入的语法match表达式语法,可以说是PHP 8引入的最好的功能之一,它使用类似switch的语法。

基本功能

$status = match($request_method) { 
'post' => $this->handlePost(), 
'get', 'head' => $this->handleGet(), 
default => throw new \Exception('Unsupported'), 
}; 

用switch…case做对比,要实现上面的功能,代码要略繁琐一点:

switch ($request_method) { 
case 'post': 
$status = $this->handlePost(); 
break; 
case 'get': 
case 'head': 
$status = $this->handleGet(); 
break; 
default: 
throw new \Exception('Unsupported'); 
}; 

相比switch, match会直接返回值,无需中间变量(比如上例中的$status)。

表达式可以返回一个值

在每个分支可以被分配给一个变量。

$name = match(2) { 
1 => 'One', 
2 => 'Two', 
}; 

不必再将返回值分配给其他中变量,匹配的语句返回值可直接从match表达式中返回。

可匹配多个条件

match表达式可能包含一个或多个匹配条件,它们的行为类似于块中的多个级联case键switch。

match($request_method) { 
'post' => $this->handlePost(), 
'get', 'head' => $this->handleGet(), 
}; 

满足$request_method === ‘get’和$request_method === ‘head’两个条件都会执行$this->handleGet()。

每个分支只能包含一个表达式

与switch可以包含任意数量的表达式的块不同,一条match语句只能包含一个表达式。

match($name) { 
'XXX' => 
init(); 
doth(); 
}; 

上面的语法错误的。=>只能有一个表达式。

隐含的break

match表达式的每个匹配分支仅允许一个表达式,并且无需switch块一样的break。

switch ('test') {  
case 'test': 
$this->doTest ();  
case 'send':  
$this->sendmsg ();  
} 

在switch…caser容易犯的错误是忘记了break语句,这会使流程直接进入下一分支。在上面的switch块中,缺少break;语句会使代码$this->doTest()无法正常执行执行。

match ('test') { 
'test' => $this->doTest (), 
'send' => $this->sendmsg (), 
}; 

match表达式无需显式break语句即可工作。它只执行一个match分支,并立即返回该值。

default分支

match语句支持一个default分支,该分支工作原理与switch…case块中的default情况类似。如果没有其他条件相匹配,将执行default match分支。

match ('DEF') { 
'aaa' => ..., 
'bbb' => ..., 
default => echo 'NO matching: ' . $name, 
}; 
 
// "NO matchin: DEFF" 

match表达式必须符合条件

switch如果没有匹配case键,则block静默进行代码流。match表达式没有。

在match表达式中,必须存在与表达式匹配的条件或default要处理的条件。如果没有匹配项,而且为设置default分支,match表达式将会引发\UnhandledMatchError异常。

$value = 3; 
match($value) { 
1 => 'One', 
2 => 'Two', 
}; 

上面的代码执行时候会抛出错误:

Fatal error: Uncaught UnhandledMatchError in ... 

match\UnhandledMatchError如果表达式中没有匹配项,则表达式将引发异常。

\UnhandledMatchError是PHP 8中的新异常类,它扩展了\Error。有关所有PHP核心异常类的完整层次结构。

该类可以很容易地扩展:

class UnhandledMatchError extends \Error {} 

对非强制类型的严格匹配

match表达式中最重要的设计选择之一是它对非强制类型的匹配。

function read(mixed $key): string { 
return match ($key) { 
1 => 'Integer 1', 
'1' => 'String 1', 
true => 'Bool true', 
[] => 'Empty array', 
[1] => 'Array [1]', 
}; 
} 
 
read(1); // "Integer 1" 
read('1'); // "String 1" 

在典型的switch块中,其大小写是松散匹配的,即与==。在match表达式中,所有匹配的分支都经过严格的比较(===)匹配。

在上面的代码段中,每个单独的分支都将匹配其值和类型。

匹配任意表达式

match 表达式允许给定值与表达式匹配。

match($httpst){ 
404 => 'Page not found', 
Response::REDIRECT => 'Redirect', 
$client->getCode() => 'Client Error', 
$response->getCode() => 'Response Error', 
default => 'Unknown error' 
}; 

表达式将按照其排列顺序进行求值。

match表达式将尝试$httpst按以下顺序进行匹配:

1. $httpst === 404 
2. $httpst === Response::REDIRECT 
3. $httpst === $client->getCode() 
4. $httpst === $response->getCode() 
5. default 

如果找到正匹配,则将不会对其他分支进行尝试,直接返回。

match VS switch

向后兼容性影响

match表达式是PHP 8中的新语法。使用match表达式的代码在较旧的PHP版本中将不起作用。