README

Smatch

适用于 PHP 7.3 和 PHP 7.4

🚀 安装

您可以使用 composer 安装此包

composer require lukasss93/smatch

👓 使用方法

smatch 函数的结构

$result = smatch('apple')
    ->case('pear', 'tasty')
    ->case('apple', 'delicious')
    ->case('banana', 'yellow')
    ->get();

// $result = 'delicious'

Case 方法值也可以接受一个闭包。

$result = smatch('apple')
    ->case('pear', fn () => 'tasty')
    ->case('apple', fn () => 'delicious')
    ->case('banana', fn () => 'yellow')
    ->get();

// $result = 'delicious'

Case 方法可以包含一个值数组

$result = smatch('chair')
    ->case(['apple', 'pear', 'banana'], 'fruit')
    ->case(['table', 'chair'], 'furniture')
    ->get();

// $result = 'furniture'

一个特殊情况是回退模式。此模式匹配之前未匹配到的任何内容。

$result = smatch('strawberry')
    ->case('pear', 'tasty')
    ->case('apple', 'delicious')
    ->case('banana', 'yellow')
    ->fallback('invalid')
    ->get();
    
// $result = 'invalid'

回退方法也可以接受一个闭包。

$result = smatch('strawberry')
    ->case('pear', 'tasty')
    ->case('apple', 'delicious')
    ->case('banana', 'yellow')
    ->fallback(fn () => 'invalid')
    ->get();
    
// $result = 'invalid'

注意：多个回退方法将覆盖最后一个。

smatch 函数必须是穷尽的。如果主题函数未被任何 case 方法处理，则抛出 UnhandledSmatchException。

未处理的 smatch 函数示例

try {
    $result = smatch('strawberry')
        ->case('pear', 'tasty')
        ->case('apple', 'delicious')
        ->case('banana', 'yellow')
        ->get();
} catch (UnhandledSmatchException $e){
    echo $e->getMessage();
}

// $e->getMessage() = Unhandled smatch value of type string

使用 getOr 方法处理缺失的回退方法

$result = smatch('car')
    ->case('pear', 'tasty')
    ->case('apple', 'delicious')
    ->case('banana', 'yellow')
    ->getOr(fn () => 'complex logic');

// $result = 'complex logic'

使用 smatch 函数处理非身份检查

可以使用 smatch 函数通过使用 true 作为主题函数来处理非身份条件情况。

使用通用 smatch 函数根据整数范围进行分支

$age = 23;

$result = smatch(true)
    ->case($age >= 65, 'senior')
    ->case($age >= 25, 'adult')
    ->case($age >= 18, 'young adult')
    ->fallback('kid')
    ->get();

// $result = 'young adult'

使用通用 smatch 函数根据字符串内容进行分支

$text = 'Bienvenue chez nous';

$result = smatch(true)
    ->case(str_contains($text, 'Welcome') || str_contains($text, 'Hello'), 'en')
    ->case(str_contains($text, 'Bienvenue') || str_contains($text, 'Bonjour'), 'fr')
    ->get();

// $result = 'fr'

⚗️ 测试

composer test

📃 更新日志

请参阅 CHANGELOG.md 了解最近更改的更多信息。

🏅 致谢

• Luca Patera
• 所有贡献者

📖 许可证

请参阅 LICENSE.md 文件了解更多信息。