PHP 8.0新功能：Match表达式

上个月下旬PHP社区发布是PHP8第一个，正式版本也将于今年年底发布。PHP8带来来那个两个最令人激动的特性:JIT和match表达式。关于PHP8 JIT有很多材料已经予以论述，我们不再赘述，参考鸟哥的blog（风雪之隅）文章可以学习。

本文我们要说另一个新引入的语法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',};

echo $name; // "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 === 4042. $httpst === Response::REDIRECT3. $httpst === $client->getCode()4. $httpst === $response->getCode()5. default

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

match VS switch

向后兼容性影响

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