PHP 8.1+ 枚举不支持实例方法和属性，仅允许静态方法与常量；readonly 属性仅禁止二次赋值，不保证对象完全不可变；readonly class 是语法糖，不替代输入校验；枚举 match 无穷尽性检查，需人工或工具保障完整性。
PHP 8.1+ 的 enum 不支持方法体，但可以带静态方法和常量
PHP 的枚举不是“类的简化版”，它本质是受限的值类型，编译期就固化了可选值。你不能在 enum 中写普通实例方法（比如 ->getName()），也不能定义属性（$value 或 $label 这类），更不能用 __construct() 初始化。
但你可以用静态方法模拟行为：
enum Status: string
{
case Draft = 'draft';
case Published = 'published';
public static function fromLabel(string $label): self
{
return match ($label) {
'草稿' => self::Draft,
'已发布' => self::Published,
default => throw new ValueError("Unknown label: $label"),
};
}
}
常见错误：试图给枚举加 public function getLabel(): string —— PHP 会报 ParseError: Enum cases cannot have methods。正确做法是把逻辑移到静态方法或外部工具类里。
- 枚举的
backed类型（string或int）必须显式声明，否则无法用->value或::from() - 未声明 backing type 的 pure enum 只能用
match或match+self::cases()做值映射 -
Status::Draft->value是合法的，但Status::Draft->name不存在 —— 名字只能通过反射或硬编码获取
readonly 属性只在构造后禁止修改，不等于“不可变对象”
readonly 修饰的是属性本身，不是整个对象。只要属性没被标记为 readonly，它依然可写；哪怕所有属性都是 readonly，你仍能调用非 readonly 方法改变内部状态（比如缓存、计数器）。
立即学习“PHP免费学习笔记（深入）”；
典型误用场景：
class User
{
public readonly string $id;
public readonly string $name;
public function __construct(string $id, string $name)
{
$this->id = $id;
$this->name = $name;
}
public function rename(string $newName): void
{
$this->name = $newName; // ⚠️ Fatal error: Cannot modify readonly property
}
}
关键点：
-
readonly属性只能在构造函数中赋值一次，之后任何写入（包括反射、__set、序列化还原）都会触发Fatal error - 数组或对象类型的
readonly属性，其内部数据仍可变（例如public readonly array $tags;→$user->tags[] = 'admin';合法） - 要真正冻结结构，得配合
array_values()、ImmutableArray类或第三方库（如spatie/immutable-array）
PHP 8.2 的 readonly 类仍需手动控制构造逻辑
readonly class 是语法糖，它自动把所有属性设为 readonly，但不会帮你校验参数、阻止重复初始化，也不会隐式调用 __construct() —— 它只是批量加 readonly，仅此而已。
下面这段代码看似安全，实则漏洞明显：
readonly class Config
{
public function __construct(
public string $host,
public int $port,
) {}
}
$config = new Config('localhost', 8080);
$config->host = 'evil.com'; // ⚠️ Fatal error —— 没问题
// 但没人阻止你传入空字符串或非法端口
$config = new Config('', -1); // ✅ 合法，但语义错误
所以你仍得自己加约束：
- 在构造函数里抛出
InvalidArgumentException校验输入 - 避免在
readonly class中定义可变依赖（如public PDO $db;），因为连接对象本身状态可变 - 不要指望
readonly class能替代 DTO 验证层 —— 它只管“写一次”，不管“写得对不对”
枚举 + 只读类组合使用时，注意 match 表达式的穷尽性检查缺失
PHP 不做枚举 match 的编译期穷尽性检查。即使你新增了一个 case，旧的 match 也不会报错或警告，运行时直接掉进 default 分支 —— 这是实际项目中最容易漏掉的逻辑缺口。
比如：
enum PaymentMethod: string
{
case CreditCard = 'card';
case BankTransfer = 'bank';
}
function feeRate(PaymentMethod $method): float
{
return match ($method) {
PaymentMethod::CreditCard => 0.029,
PaymentMethod::BankTransfer => 0.005,
// 新增 PayPal 后这里没更新 → 默认返回 0.0
default => 0.0,
};
}
解决办法有限：
- 用
match ($method) { ... }+ 显式列出全部 case，不用default（但 PHP 不强制，靠人盯） - 配合静态分析工具（如 PHPStan +
phpstan-phpunit插件）识别遗漏分支 - 测试覆盖所有
cases()，并在 CI 中 assert 返回值非零
最麻烦的其实是跨版本协作：PHP 8.1 枚举 + 8.2 只读类 + 8.3 的新 enum 方法支持（如 __toString）混用时，IDE 提示、类型推导和错误捕获会断层。别默认“用了新语法就更安全”，该写的校验一行都不能少。
