PHP字符串转枚举的实用方法

编程并不是一个机械性的工作，而是需要有思考，有创新的工作，语法是固定的，但解决问题的思路则是依靠人的思维，这就需要我们坚持学习和更新自己的知识。今天golang学习网就整理分享《PHP枚举：字符串转枚举的实现方法》，文章讲解的知识点主要包括，如果你对文章方面的知识点感兴趣，就不要错过golang学习网，在这可以对大家的知识积累有所帮助，助力开发能力的提升。

本文深入探讨了在PHP中如何根据字符串获取枚举（Enum）案例的多种方法。我们将详细介绍针对支持值枚举（BackedEnums）的`tryFrom()`和`from()`原生方法，以及如何为不带值的枚举（Simple Enums）或需要通过案例名称获取时，实现自定义的静态辅助方法。文章旨在提供清晰的指导和代码示例，帮助开发者高效地处理枚举与字符串之间的转换。

在PHP 8.1及更高版本中引入的枚举（Enums）为我们提供了一种定义一组有限、命名值的方式，极大地提升了代码的可读性和类型安全性。根据其定义方式，枚举可分为两种类型：不带值的枚举（Simple Enums）和支持值枚举（BackedEnums）。理解这两种类型及其特性，是高效地从字符串获取枚举案例的基础。

1. 理解 PHP 枚举类型

1.1 不带值的枚举 (Simple Enums)

不带值的枚举，也称为纯枚举，其案例仅作为符号存在，不关联任何标量值。它们主要用于表示一组互斥的状态或选项。

1.2 支持值枚举 (BackedEnums)
支持值枚举允许每个案例关联一个明确的标量值（int 或 string）。这些值可以在外部系统（如数据库、API）中使用，从而实现枚举与外部数据源的无缝集成。
2. 访问枚举案例的属性
无论是哪种枚举，都可以通过->name属性获取其案例的字符串名称。对于支持值枚举，还可以通过->value属性获取其关联的标量值。
name;  // 输出: "OK"
echo Status::OK->value; // 输出: "OK" (对于string BackedEnum)

enum SimpleStatus
{
    case ACTIVE;
    case INACTIVE;
}

echo SimpleStatus::ACTIVE->name; // 输出: "ACTIVE"
// SimpleStatus::ACTIVE->value; // 错误：Simple Enum 没有 value 属性
3. 原生方法：通过值获取支持值枚举 (BackedEnums) 案例
PHP为支持值枚举提供了原生的静态方法tryFrom()和from()，允许开发者通过其关联的标量值来获取对应的枚举案例。
3.1 BackedEnum::tryFrom(string|int $value)
此方法尝试根据提供的标量值查找并返回匹配的枚举案例。如果找不到匹配的案例，它将返回null。
3.2 BackedEnum::from(string|int $value)
与tryFrom()类似，但如果找不到匹配的案例，from()方法会抛出一个ValueError异常。这适用于你确定输入值一定有效，或者希望显式捕获并处理错误的情况。
getMessage() . "\n";
}
注意事项： tryFrom()和from()方法是针对支持值枚举的值进行匹配的，而不是案例名称。如果你的字符串是案例名称而不是值，这些方法将无法直接使用。
4. 自定义方法：通过名称获取枚举案例
对于不带值的枚举，或者当你想通过枚举案例的名称（而不是值）来获取案例时，PHP没有提供原生的静态方法。在这种情况下，你需要实现一个自定义的静态辅助方法。
一个常见的实现方式是遍历枚举的所有案例（通过Enum::cases()方法），然后比较每个案例的->name属性与输入的字符串。
name === $name) {
                return $statusCase;
            }
        }
        return null;
    }
}

$statusOk = Status::get("OK"); // 返回 Status::OK
var_dump($statusOk);

$statusPending = Status::get("pending "); // 返回 Status::PENDING (处理了大小写和空格)
var_dump($statusPending);

$statusNotFound = Status::get("UNKNOWN"); // 返回 null
var_dump($statusNotFound);

// 同样适用于 BackedEnum，如果你想通过名称而不是值获取
enum HttpMethod: string
{
    case GET = "GET";
    case POST = "POST";

    public static function getByName(string $name): ?self
    {
        $name = strtoupper(trim($name));
        if (empty($name)) {
            return null;
        }
        foreach (self::cases() as $methodCase) {
            if ($methodCase->name === $name) {
                return $methodCase;
            }
        }
        return null;
    }
}

$method = HttpMethod::getByName("post"); // 返回 HttpMethod::POST
var_dump($method);
这个自定义的get方法提供了强大的灵活性，可以根据你的需求添加额外的逻辑，例如处理大小写不敏感的匹配、去除空格等。
5. 选择合适的策略与最佳实践
使用支持值枚举 (BackedEnums) 和 tryFrom()/from()： 如果你的枚举案例与外部系统中的特定字符串或整数值直接关联，并且你希望通过这些值进行查找，那么使用支持值枚举是最佳选择。这提供了原生支持，代码简洁且性能高效。
使用自定义 get 方法： 如果你的枚举是不带值的，或者你需要通过枚举案例的名称（而非其值）进行查找，那么实现一个自定义的静态方法是必要的。这种方法提供了最大的灵活性，可以根据实际需求定制匹配逻辑。
错误处理： tryFrom()返回null，from()抛出ValueError。自定义方法通常返回null。选择哪种方式取决于你对未找到匹配情况的处理策略。
大小写敏感性： 在实现自定义get方法时，请考虑是否需要进行大小写不敏感的匹配。使用strtoupper()、strtolower()或strcasecmp()可以实现这一目标。
命名约定： 保持枚举案例名称与你期望通过字符串查找的名称之间的一致性，有助于减少混淆。
总结
从字符串获取PHP枚举案例的方法取决于枚举的类型以及你希望匹配的是案例的“值”还是“名称”。对于支持值枚举，tryFrom()和from()提供了高效的原生解决方案，通过匹配其关联的标量值来获取案例。然而，若要通过案例的字符串名称获取，尤其是不带值的枚举，则需要实现一个自定义的静态辅助方法，遍历所有案例并比较其->name属性。理解这些差异并选择合适的策略，将有助于你更有效地利用PHP枚举，编写出健壮且易于维护的代码。
今天关于《PHP字符串转枚举的实用方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！