【PHP8.x】T_MATCH定数の使い方

Copy
1<?php
2
3/**
4 * HTTPステータスコードに基づいて説明メッセージを返します。
5 *
6 * T_MATCH はPHP 8で導入された 'match' 式のキーワードを表すパーサートークンです。
7 * 通常のアプリケーションコードで直接使用することはありませんが、
8 * ここでは、キーワードで指定された 'match()' に最も関連性の高い、
9 * PHP 8で導入された 'match' 式の具体的な使用例を示します。
10 * 'match' 式は、従来の 'switch' 文よりも簡潔かつ強力に値の比較を行い、結果を返すことができます。
11 *
12 * @param int $statusCode HTTPステータスコード
13 * @return string ステータスコードの説明メッセージ
14 */
15function getStatusMessage(int $statusCode): string
16{
17    // PHP 8で導入された 'match' 式を使用しています。
18    // 'match' は値を厳密に比較 (===) し、対応する値を返します。
19    // 各ケースはカンマ区切りで複数の値を指定でき、最終的に必ず値を返す必要があります。
20    // どの条件にもマッチしない場合に備えて、'_ =>' (デフォルト) を含めるのが一般的です。
21    return match ($statusCode) {
22        200 => 'OK',
23        201 => 'Created',
24        204 => 'No Content',
25        301, 302 => 'Redirect', // 複数の値を同じ結果にマッピング
26        400 => 'Bad Request',
27        401 => 'Unauthorized',
28        403 => 'Forbidden',
29        404 => 'Not Found',
30        500 => 'Internal Server Error',
31        // どの値にもマッチしない場合のデフォルト処理。
32        // これを含まないと、マッチしない値が渡された場合に UnhandledMatchError がスローされます。
33        _ => 'Unknown Status',
34    };
35}
36
37// サンプルコードの実行例
38echo "HTTP 200: " . getStatusMessage(200) . PHP_EOL;
39echo "HTTP 404: " . getStatusMessage(404) . PHP_EOL;
40echo "HTTP 301: " . getStatusMessage(301) . PHP_EOL;
41echo "HTTP 500: " . getStatusMessage(500) . PHP_EOL;
42echo "HTTP 100: " . getStatusMessage(100) . PHP_EOL; // 未定義のステータスコード
43
44?>

PHPのT_MATCHは、PHP 8で導入された「match式」のキーワードを示すパーサートークンです。このT_MATCHは直接アプリケーションコードで使うものではありませんが、match式自体は非常に便利な機能です。

このサンプルコードでは、match式の具体的な使用例として、HTTPステータスコードに対応する説明メッセージを返すgetStatusMessage関数を定義しています。引数$statusCodeにはHTTPステータスコード（整数値）を渡し、戻り値としてその説明（文字列）が返されます。

match式は、従来のswitch文よりも簡潔に記述でき、値を厳密に比較（===）して結果を直接返す点が特徴です。複数の値をカンマ区切りで同じ結果にマッピングでき、必ず値を返す必要があります。そのため、どの条件にもマッチしない場合に備えて、_ =>というデフォルトケースを含めることが重要です。これを省略すると、マッチしない値が渡された際にUnhandledMatchErrorがスローされます。サンプル実行では、入力されたステータスコードに応じて適切なメッセージが返される様子を確認できます。

Copy
1<?php
2
3/**
4 * 指定されたエラーコードに対応するメッセージを返します。
5 * PHP 8で導入されたmatch文を使用して、簡潔に条件分岐を記述します。
6 * match文は値を返す式であり、厳密な比較 (===) を行います。
7 *
8 * @param int $errorCode エラーコード
9 * @return string エラーメッセージ
10 */
11function getErrorMessage(int $errorCode): string
12{
13    // T_MATCH は、PHPの内部でmatchキーワードを識別するために使われるトークン定数です。
14    // 一般的なアプリケーションコードで直接使用することはありませんが、
15    // match文の存在を示す文脈で言及されることがあります。
16    return match ($errorCode) {
17        1001 => 'ファイルが見つかりません。',
18        1002 => 'アクセス権限がありません。',
19        1003 => 'データベース接続エラーです。',
20        1004, 1005 => '入力データが無効です。', // 複数の値をコンマで区切って指定可能
21        default => '不明なエラーが発生しました。', // 全てのケースをカバーしない場合に必須
22    };
23}
24
25// サンプルコードの実行例
26echo "Error 1001: " . getErrorMessage(1001) . PHP_EOL;
27echo "Error 1004: " . getErrorMessage(1004) . PHP_EOL;
28echo "Error 2000: " . getErrorMessage(2000) . PHP_EOL;
29
30?>

PHPのT_MATCHは、プログラミング言語の内部処理で使われるトークン定数の一つです。これは、PHPスクリプト内でmatchというキーワードが使われた際に、PHPのパーサーがそのキーワードを識別するために利用するものであり、通常のアプリケーションコードで直接使用することはありません。

サンプルコードは、PHP 8で導入されたmatch文（マッチ式）の具体的な使用例を示しています。match文は、従来のswitch文に似ていますが、より簡潔で表現力が高いのが特徴です。この文は値を返す「式」であるため、変数に直接代入したり、関数からの戻り値として利用したりすることができます。

getErrorMessage関数は、引数として渡された整数型のエラーコード（$errorCode）を受け取り、それに対応する文字列のエラーメッセージを返します。この関数内でmatch文を使用することで、エラーコードに応じたメッセージを効率的に分岐させています。

match文は、指定された値とケースの値を厳密に比較（===）します。複数のケース値をカンマで区切って一つの結果に対応させることも可能です。また、全てのケースを網羅しない場合のために、必ずdefaultケースを指定する必要があります。これにより、予期せぬ入力値に対しても適切な処理を行うことができます。この簡潔な記述により、コードの可読性と保守性が向上します。