PHP项目类常量与枚举常量

本文目录导读：

1. 定义方式
2. 核心区别
3. 具体对比场景
4. 什么时候选类常量？
5. 什么时候选枚举？
6. 性能对比
7. 最佳实践建议

在PHP中,类常量（使用const定义）和枚举常量（PHP 8.1+引入的enum）虽然都用于定义固定值，但它们在设计目的、功能和使用场景上有显著区别，下面从多个维度进行对比。

定义方式

类常量

class OrderStatus {
    const PENDING = 'pending';
    const PAID = 'paid';
    const SHIPPED = 'shipped';
}

枚举常量（PHP 8.1+）

enum OrderStatus: string {
    case PENDING = 'pending';
    case PAID = 'paid';
    case SHIPPED = 'shipped';
}

核心区别

具体对比场景

场景1：类型安全

function processPayment(string $status) { ... }  // 类常量，可以传任意字符串
processPayment('invalid_status');  // 没报错，但逻辑错误
function processPayment(OrderStatus $status) { ... }  // 枚举，只能传合法值
processPayment(OrderStatus::PAID);  // ✅ 正确
processPayment('invalid_status');  // ❌ 编译错误

场景2：添加行为

// 类常量 - 无法直接添加方法
class OrderStatusClass {
    const PENDING = 0;
    const PAID = 1;
}
// 枚举可以包含方法
enum OrderStatusEnum: int {
    case PENDING = 0;
    case PAID = 1;
    public function label(): string {
        return match($this) {
            self::PENDING => '待支付',
            self::PAID => '已支付',
        };
    }
}
echo OrderStatusEnum::PENDING->label();  // 输出：待支付

场景3：枚举支持接口实现

interface HasColor {
    public function color(): string;
}
enum Status: string implements HasColor {
    case ACTIVE = 'active';
    case INACTIVE = 'inactive';
    public function color(): string {
        return match($this) {
            self::ACTIVE => 'green',
            self::INACTIVE => 'gray',
        };
    }
}

什么时候选类常量？

• PHP版本低于8.1
• 简单项目，不需要类型安全
• 作为配置项，值本身是字符串/数字，无需行为
• 兼容性要求高（如公共库）

class Config {
    const API_URL = 'https://api.example.com';
    const TIMEOUT = 30;
}

什么时候选枚举？

• PHP 8.1+ 的新项目
• 需要强类型限制的场景（如状态机、选项列表）
• 多个相关值需要绑定行为（比如每个状态有不同的业务逻辑）
• 需要序列化/反序列化（枚举支持直接json_encode）

enum HttpMethod: string {
    case GET = 'GET';
    case POST = 'POST';
    case PUT = 'PUT';
    public function isIdempotent(): bool {
        return match($this) {
            self::GET, self::PUT => true,
            self::POST => false,
        };
    }
}

性能对比

性能差异极小,通常可忽略不计，枚举的额外开销换来的是类型安全和可维护性。

最佳实践建议

1. 新项目（PHP 8.1+）：优先使用枚举代替类的状态常量
2. 混合项目：保留类常量直到完全迁移
3. 配置常量：仍然使用类常量（如Config::API_URL）
4. 枚举只用于具有明确意义的有限集合，而非大量随机值

// ✅ 好的枚举使用
enum PaymentMethod { case CREDIT_CARD; case PAYPAL; }
// ❌ 不要用枚举替代所有常量
class Constants {
    const PI = 3.14159;  // 类常量更合适
}

一句话判断：如果常量集合代表"可选值"（比如状态、类型、模式），用枚举；如果只是"固定值"（配置、数学常量），用类常量。