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

<?php
declare(strict_types=1);

enum OrderState
{
    case New;
    case Paid;
    public function label(): string
    {
        return match ($this) { self::New => 'Новый', self::Paid => 'Оплачен' };
    }
}
foreach (OrderState::cases() as $state) {
    echo $state->name, ': ', $state->label(), "\n";
}

New: Новый
Paid: Оплачен

Каждый enum автоматически выполняет UnitEnum, который задаёт cases(): array. Метод возвращает все варианты в порядке объявления. name — имя варианта в программе; человеческую подпись задаёт label. Нельзя реализовать UnitEnum обычным классом и получить таким способом собственный enum.

<?php
declare(strict_types=1);

enum OrderState: string { case New = 'new'; case Paid = 'paid'; }
$databaseRow = ['id' => 42, 'status' => 'paid'];
$state = OrderState::from($databaseRow['status']);
echo 'Заказ ', $databaseRow['id'], ': ', $state === OrderState::Paid ? 'оплачен' : 'новый', "\n";
echo 'Код для сохранения: ', $state->value, "\n";

Заказ 42: оплачен
Код для сохранения: paid

BackedEnum расширяет договор UnitEnum: к cases добавляет from/tryFrom и у вариантов есть value. from ищет по скалярному коду, а не по русской подписи или имени Paid. Известная строка из проверенного хранилища даёт конкретный case; повреждённое значение потребует обработки ValueError.

<?php
declare(strict_types=1);

enum Delivery: string { case Pickup = 'self'; case Courier = 'door'; }
$wrong = Delivery::tryFrom('Pickup');
echo $wrong === null ? "API не знает код Pickup\n" : "Код найден\n";
$selected = Delivery::from('self');
echo 'Выбран вариант: ', $selected->name, "\n";
echo 'Отправить в API: ', $selected->value, "\n";

API не знает код Pickup
Выбран вариант: Pickup
Отправить в API: self

Внутреннее имя case можно выбрать по стилю кода, а внешний value должен соответствовать договору сервиса. from и tryFrom работают с value. Не переименовывайте сохранённые коды без миграционного плана.

<?php
enum OrderState: string { case New = 'new'; case Paid = 'paid'; }
$payload = ['status' => 'cancelled'];
$raw = $payload['status'] ?? null;
if (!is_string($raw)) {
    echo "Статус должен быть строкой\n";
} else {
    $state = OrderState::tryFrom($raw);
    echo $state === null ? "Неизвестный статус\n" : $state->name . "\n";
}

Неизвестный статус

Проверка типа и проверка множества вариантов — разные этапы. HTTP-обработчик на этом месте вернёт понятную ошибку валидации, а не молча сменит состояние заказа.

<?php
declare(strict_types=1);
enum Priority: int { case Normal = 1; case High = 2; }
echo Priority::from(1)->name, "\n";
try { Priority::tryFrom('1'); }
catch (TypeError $error) { echo "Требуется int\n"; }

Normal
Требуется int

В strict_types=1 int-backed enum не принимает строку "1". В нестрогом вызове PHP может преобразовать подходящее скалярное значение; это не замена проверке входа. Приведение (int) произвольного текста способно превратить ошибку в 0.

<?php
enum Priority: int { case Normal = 1; case High = 2; }
echo Priority::from('1')->name, "\n";

Normal

Этот пример специально не содержит declare(strict_types=1). Разница определяется местом вызова. Для предсказуемого API нормализуйте вход по явным правилам, а не стройте проверку на побочных преобразованиях.