Master PHP 8's match Expression: Safer, Cleaner Alternatives to switch

PHP provides the switch statement for branching, but since PHP 8.0 a new match expression offers stricter comparison (===) and can directly return values.

Basic Usage

Consider a typical switch that prints messages based on an error code:

$errorCode = 2;
switch ($errorCode) {
    case 1:
        echo 'Access denied';
        break;
    case 2:
        echo 'Incorrect password';
        break;
    case 3:
        echo 'Invalid format';
        break;
}

The same logic can be rewritten with match:

$errorCode = 2;
echo match ($errorCode) {
    1 => 'Access denied',
    2 => 'Incorrect password',
    3 => 'Invalid format',
};

Another example sets a message based on a user's role:

$user = User::find(1);
$message = match ($user->role) {
    'admin' => '欢迎，管理员！',
    'user'  => '你好，用户！',
    default => '你好，访客！',
};
echo $message;

Using Conditions in Branches

match

allows each branch to be a condition, evaluated when the expression’s value is true:

$status = match (true) {
    $order->isPending()  => '待处理',
    $order->isShipped()  => '已发货',
    $order->isDelivered()=> '已交付',
    default              => '未知状态',
};

Only the first true condition is executed.

Combining with Enums

Match works well with PHP enums. Given an enum for user status:

enum UserStatus: string {
    case Active   = 'active';
    case Inactive = 'inactive';
    case Suspended= 'suspended';
}

You can map enum values to friendly names:

$status = UserStatus::Active;
$friendlyStatus = match ($status) {
    UserStatus::Active   => '活跃',
    UserStatus::Inactive => '非活跃',
    UserStatus::Suspended=> '已暂停',
    default              => '未知',
};

Practical Example: Driver Factory

Use match as a simple factory to instantiate database drivers based on an environment variable:

$driver = $_ENV['DB_DRIVER'] ?? 'mysql';
$db = match ($driver) {
    'mysql', 'mariadb' => new MySQLDriver(),
    'pgsql'           => new PostgreSQLDriver(),
    'sqlite'          => new SQLiteDriver(),
    default           => throw new InvalidArgumentException("不支持的驱动: $driver"),
};

This example defines four branches; the first three return driver instances, while the default branch throws an exception for unsupported drivers.

Conclusion

The match expression provides a more powerful and safer alternative to switch by enforcing strict type comparison and allowing direct returns, reducing boilerplate and potential bugs.