PHP: полный мануал с примерами, функциями и ООП

<?php
enum OrderStatus: string
{
    case New = 'new';
    case Paid = 'paid';
    case Shipped = 'shipped';

    public function label(): string
    {
        return match ($this) {
            self::New => 'Новый',
            self::Paid => 'Оплачен',
            self::Shipped => 'Отправлен',
        };
    }
}

$status = OrderStatus::Paid;
echo $status->value, ': ', $status->label(), "\n";

paid: Оплачен

Backed enum связывает каждый case с уникальной строкой или целым числом. В базе и JSON можно хранить value, а внутри программы передавать OrderStatus, не произвольную строку. Метод enum держит отображение рядом с допустимыми состояниями.

<?php
enum Delivery: string
{
    case Courier = 'courier';
    case Pickup = 'pickup';
}

foreach (['pickup', 'drone'] as $raw) {
    $delivery = Delivery::tryFrom($raw);
    echo $delivery?->name ?? 'Недопустимо', "\n";
}

Pickup
Недопустимо

tryFrom() возвращает case или null; это удобно на границе формы/API. from() вместо этого бросает ValueError. У чистого enum без string/int нет from, tryFrom и свойства value.

<?php
enum Access
{
    case Guest;
    case Admin;
}

$first = Access::Admin;
$second = Access::Admin;

echo $first === $second ? "Один и тот же case\n" : "Разные объекты\n";
echo $first->name, "\n";

Один и тот же case
Admin

Case ведёт себя как объект и допускает методы, но его нельзя создать через new или клонировать. Каждый объявленный case — один стабильный экземпляр. Свойство name есть у всех enum; value — только у backed enum.

<?php
enum PaymentMethod: string
{
    case Card = 'card';
    case Cash = 'cash';
    case Invoice = 'invoice';

    public function label(): string
    {
        return match ($this) {
            self::Card => 'Карта',
            self::Cash => 'Наличные',
            self::Invoice => 'Счёт',
        };
    }
}

foreach (PaymentMethod::cases() as $method) {
    echo $method->value, ' => ', $method->label(), "\n";
}

card => Карта
cash => Наличные
invoice => Счёт

cases() возвращает плотный массив case в порядке объявления. Для backed enum доступны name и value. Отображаемую подпись лучше хранить в методе или слое локализации, а не показывать техническое имя пользователю.