PHP Academy · 课时

枚举（Enums）

Q: 「枚举（Enums）」这节课中我会学到什么？

使用 PHP 8.1 的有 backing value 枚举和纯枚举，定义类型安全的值集合。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用 PHP 8.1 的有 backing value 枚举和纯枚举，定义类型安全的值集合。

枚举（Enums） 是 CoddyKit 上的免费 PHP Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

什么是枚举

PHP 8.1 引入了枚举，这是一种特殊类型，可以将变量限制为一组预定义的命名值，使代码表达力更强且更安全。

纯枚举（单元枚举）

纯枚举包含带名称的枚举项，但不关联任何值。它非常适合表示状态、方向或状态码。

<?php
enum Status {
    case Active;
    case Inactive;
    case Banned;
}

$s = Status::Active;
echo $s->name; // "Active"

有支持值的枚举

有支持值的枚举会为每个枚举项分配一个标量值（整数或字符串），适合用于数据库存储或应用程序接口响应。

<?php
enum Color: string {
    case Red   = "red";
    case Green = "green";
    case Blue  = "blue";
}

echo Color::Red->value; // "red"

From 与 TryFrom

可以使用 from() 将原始值转换回枚举项（无效时抛出异常），也可以使用 tryFrom()（无效时返回 null）。

<?php
$color = Color::from("red");      // Color::Red
$maybe = Color::tryFrom("purple"); // null

类型提示中的枚举

请将枚举用作参数和返回类型的类型提示，PHP 会确保只能传入有效的枚举项。

<?php
function paint(Color $color): void {
    echo "Painting with ".$color->value;
}
paint(Color::Blue); // "Painting with blue"

match 中的枚举项

枚举与 match 表达式结合使用，可以优雅地处理所有可能的情况。

<?php
$label = match($status) {
    Status::Active   => "Active user",
    Status::Inactive => "Inactive account",
    Status::Banned   => "Banned",
};
// PHP can warn if cases are unhandled

枚举实现接口

枚举可以实现接口，从而支持多态行为。

<?php
interface HasLabel {
    public function label(): string;
}

enum Status: string implements HasLabel {
    case Active   = "active";
    case Inactive = "inactive";
    public function label(): string {
        return ucfirst($this->value);
    }
}

枚举方法

枚举可以包含方法，但不能包含构造函数或可变属性。

<?php
enum Suit: string {
    case Hearts   = "H";
    case Diamonds = "D";
    case Clubs    = "C";
    case Spades   = "S";

    public function color(): string {
        return match($this) {
            Suit::Hearts, Suit::Diamonds => "red",
            Suit::Clubs,  Suit::Spades  => "black",
        };
    }
}

枚举常量

枚举可以包含常量（而不是枚举项），用于表示相关的标量值。

<?php
enum Direction {
    case North;
    case South;
    const DEFAULT = self::North;
}

列出枚举项

EnumName::cases() 会返回包含所有枚举项对象的数组，可用于生成下拉选项。

<?php
$options = Color::cases();
foreach ($options as $c) {
    echo $c->name.": ".$c->value."\n";
}

枚举与类常量

枚举可以保证类型安全：当需要 Status 枚举时，您不能意外传入整数 1。类常量则无法提供这样的保证。

总结

枚举可以在保证类型安全的同时表示固定的值集合。请使用纯枚举表示状态；当需要数据库值或应用程序接口值时，请使用有支持值的枚举。请使用 tryFrom() 进行安全解析。

快速检查

如果没有枚举项匹配，Color::tryFrom("invalid") 会返回什么？

常见问题解答

「枚举（Enums）」课时是免费的吗？

是的 — 「枚举（Enums）」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。

「枚举（Enums）」这节课中我会学到什么？

使用 PHP 8.1 的有 backing value 枚举和纯枚举，定义类型安全的值集合。你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 PHP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「枚举（Enums）」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 PHP Academy 课中编写并运行代码吗？

能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 PHP Academy