As well as being similar to a switch, match expressions can be thought of as enhanced lookup tables — for when a simple array lookup isn't enough without extra handling of edge cases, but a full switch statement would be overweight.
For a familiar example, the following
<?php
function days_in_month(string $month): int
{
static $lookup = [
'jan' => 31,
'feb' => 0,
'mar' => 31,
'apr' => 30,
'may' => 31,
'jun' => 30,
'jul' => 31,
'aug' => 31,
'sep' => 30,
'oct' => 31,
'nov' => 30,
'dec' => 31
];
$name = strtolower(substr($name, 0, 3));
if(isset($lookup[$name])) {
if($name == 'feb') {
return is_leap($year) ? 29 : 28;
} else {
return $lookup[$name];
}
}
throw new InvalidArgumentException("Bogus month");
}
?>
with the fiddly stuff at the end, can be replaced by
<?php
function days_in_month(string $month): int
{
return match(strtolower(substr($name, 0, 3))) {
'jan' => 31,
'feb' => is_leap($year) ? 29 : 28,
'mar' => 31,
'apr' => 30,
'may' => 31,
'jun' => 30,
'jul' => 31,
'aug' => 31,
'sep' => 30,
'oct' => 31,
'nov' => 30,
'dec' => 31,
default => throw new InvalidArgumentException("Bogus month"),
};
}
?>
Which also takes advantage of "throw" being handled as of PHP 8.0 as an expression instead of a statement.
match
(PHP 8)
Выражение match предназначено для ветвления потока исполнения на
основании проверки совпадения значения с заданным условием.
Аналогично оператору switch, выражение
match принимает на вход выражение, которое сравнивается
с множеством альтернатив. Но, в отличие от switch,
оно обрабатывает значение в стиле, больше похожем на тернарный оператор.
Также, в отличие от switch, используется строгое сравнение
(===), а не слабое (==).
Выражение match доступно начиная с PHP 8.0.0.
Пример #1 Структура выражения match
<?php
$return_value = match (subject_expression) {
single_conditional_expression => return_expression,
conditional_expression1, conditional_expression2 => return_expression,
};
?>Пример #2 Простой пример использования match
<?php
$food = 'cake';
$return_value = match ($food) {
'apple' => 'На столе лежит яблоко',
'banana' => 'На столе лежит банан',
'cake' => 'На столе стоит торт',
};
var_dump($return_value);
?>Результат выполнения приведённого примера:
string(35) "На столе стоит торт"
Замечание: Результат
matchиспользовать не обязательно.
Замечание: Выражение
matchдолжно завершаться точкой с запятой;.
Выражение match похоже на оператор
switch за исключением некоторых ключевых отличий:
-
В отличие от switch, в
matchиспользуется строгое сравнение (===). -
Выражение
matchвозвращает результат. -
В
matchисполняется только одна, первая подошедшая, ветвь кода, тогда как вswitchпроисходит сквозное исполнение начиная с подошедшего условия и до первого встретившегося оператораbreak. -
Выражение
matchдолжно быть исчерпывающим.
Также как и оператор switch, match
последовательно проводит проверки на совпадение с заданными условиями.
Выполнение кода условий происходит лениво, т.е. код следующего условия выполняется только
если все предыдущие проверки провалились. Будет выполнена только одна ветвь кода,
соответствующая подошедшему условию.
Пример:
<?php
$result = match ($x) {
foo() => ...,
$this->bar() => ..., // $this->bar() не будет выполнен, если foo() === $x
$this->baz => beep(), // beep() будет выполнен только если $x === $this->baz
// etc.
};
?>
Условия в match могут быть множественными. В этом случае их следует разделять запятыми.
Множественные условия работают по принципу логического ИЛИ и, по сути, являются
сокращённой формой для случаев, когда несколько условий должны обрабатываться идентично.
<?php
$result = match ($x) {
// Множественное условие:
$a, $b, $c => 5,
// Аналогично трём одиночным:
$a => 5,
$b => 5,
$c => 5,
};
?>
Также можно использовать шаблон default.
Этот шаблон совпадает с чем угодно, для чего не нашлось совпадений раньше.
К примеру:
<?php
$expressionResult = match ($condition) {
1, 2 => foo(),
3, 4 => bar(),
default => baz(),
};
?>Замечание: Использование нескольких шаблонов default приведёт к фатальной ошибке
E_FATAL_ERROR.
Выражение match должно быть исчерпывающим. Если
проверяемое выражение не совпало ни с одним из условий, то будет
выброшено исключение UnhandledMatchError.
Пример #3 Пример необработанного выражения
<?php
$condition = 5;
try {
match ($condition) {
1, 2 => foo(),
3, 4 => bar(),
};
} catch (\UnhandledMatchError $e) {
var_dump($e);
}
?>Результат выполнения приведённого примера:
object(UnhandledMatchError)#1 (7) {
["message":protected]=>
string(33) "Unhandled match value of type int"
["string":"Error":private]=>
string(0) ""
["code":protected]=>
int(0)
["file":protected]=>
string(9) "/in/ICgGK"
["line":protected]=>
int(6)
["trace":"Error":private]=>
array(0) {
}
["previous":"Error":private]=>
NULL
}
Использование match для проверки сложных условий
Выражение match можно использовать не только для проверки идентичности,
но и для любых выражений, возвращающих логическое значение. В этом случае в качестве входного
параметра передаётся выражение true.
Пример #4 Использование match для ветвления в зависимости от вхождения в диапазоны целых чисел
<?php
$age = 23;
$result = match (true) {
$age >= 65 => 'пожилой',
$age >= 25 => 'взрослый',
$age >= 18 => 'совершеннолетний',
default => 'ребёнок',
};
var_dump($result);
?>Результат выполнения приведённого примера:
string(11) "совершеннолетний"
Пример #5 Использование match для ветвления в зависимости от содержимого строки
<?php
$text = 'Bienvenue chez nous';
$result = match (true) {
str_contains($text, 'Welcome') || str_contains($text, 'Hello') => 'en',
str_contains($text, 'Bienvenue') || str_contains($text, 'Bonjour') => 'fr',
// ...
};
var_dump($result);
?>Результат выполнения приведённого примера:
string(2) "fr"
add a note
User Contributed Notes 4 notes
Hayley Watson ¶
3 years ago
darius dot restivan at gmail dot com ¶
3 years ago
This will allow for a nicer FizzBuzz solution:
<?php
function fizzbuzz($num) {
print match (0) {
$num % 15 => "FizzBuzz" . PHP_EOL,
$num % 3 => "Fizz" . PHP_EOL,
$num % 5 => "Buzz" . PHP_EOL,
default => $num . PHP_EOL,
};
}
for ($i = 0; $i <=100; $i++)
{
fizzbuzz($i);
}
lewiscowles at me dot com ¶
3 years ago
The comment correcting Hayley's example misses that year is also present in the example, but not a function argument.
Most code from PHP.net should not be copied without user care. It was nonetheless, a great example of using short syntax to reduce complexity.
webmaster at warkensoft dot com ¶
3 years ago
In the "familiar example" presented by Hayley Watson the following code is incorrect:
strtolower(substr($name, 0, 3))
It should instead be written in both instances as:
strtolower(substr($month, 0, 3))
