Вступ: Що таке PHP Enums і чому це важливо?

У постійно змінюваному світі PHP-розробки, PHP 8.1 представив революційну функцію, яка може значно покращити якість вашого коду: Enums. Якщо ви втомилися використовувати кілька констант або стикаєтеся з проблемами безпеки типів, цей посібник покаже вам, як Enums можуть змінити ваш підхід до програмування на PHP.

Enums у PHP від arifhossen.dev

Що саме таке PHP Enums?

PHP Enums (перерахування) — це структурований спосіб визначення набору іменованих констант з додатковими можливостями. На відміну від традиційних констант, Enums надають:

• Безпеку типів
• Розширену функціональність
• Чітку структуру коду
• Покращену зручність для читання

Простий приклад для початку

enum OrderStatus {  
 case PENDING;  
 case PROCESSING;  
 case SHIPPED;  
 case DELIVERED;  
}

Реальні приклади використання: Як оживити Enums

1.

User prefers translations to keep the original code intact and ensure natural-sounding Ukrainian while adding English terms in parentheses for technical jargon.
Управління замовленнями в електронній комерції

Уявіть, що ви створюєте платформу для електронної комерції. Перерахування (Enums) ідеально підходять для управління статусами замовлень:

enum OrderStatus {  
 case PENDING;  
 case PROCESSING;  
 case SHIPPED;  
 case DELIVERED;  
 case CANCELLED;  

 public function getDescription(): string {  
 return match($this) {  
 self::PENDING => 'Замовлення отримано, очікує на обробку',  
 self::PROCESSING => 'Замовлення обробляється',  
 self::SHIPPED => 'Замовлення в дорозі',  
 self::DELIVERED => 'Замовлення успішно доставлено',  
 self::CANCELLED => 'Замовлення скасовано'  
 };  
 }  
}  

// Використання  
$status = OrderStatus::PENDING;  
echo $status->getDescription(); // "Замовлення отримано, очікує на обробку"

2.

Управління ролями користувачів

Перерахування (Enums) з підтримкою значень дозволяють асоціювати скалярні значення з випадками перерахування:

enum UserRole: string {  
 case ADMIN = 'administrator';  
 case EDITOR = 'content_editor';  
 case VIEWER = 'read_only';  

 public function getAccessLevel(): int {  
 return match($this) {  
 self::ADMIN => 3,  
 self::EDITOR => 2,  
 self::VIEWER => 1  
 };  
 }  
}

Основні переваги використання перерахувань (Enums) в PHP

1. Безпека типів (Type Safety): Перевірки компілятора запобігають неправильному використанню
2. Читабельність коду (Code Clarity): Явне визначення можливих значень
3. Розширюваність (Extensibility): Додавання методів і поведінки до випадків перерахування
   4.
   Продуктивність: Легкий та ефективний

Типові помилки, яких слід уникати

• Не використовуйте занадто багато переліків (enums) для всього
• Пам'ятайте, що переліки (enums) не можна ініціалізувати
• Використовуйте переліки з підтримкою значень (backed enums), коли потрібні скалярні значення

Коли використовувати переліки (enums)

Чудово підходять для таких сценаріїв:

• Відстеження статусу
• Ролі користувачів та дозволи
• Методи оплати
• Параметри конфігурації
• Типи сповіщень

Розгляди продуктивності

Переліки (enums) є легкими і мають мінімальні витрати на продуктивність.
Вони компілюються в ефективний код, що робить їх чудовим вибором для складних додатків.

Сумісність з браузерами та версія PHP

• Потрібна версія PHP 8.1+
• Підтримується всіма сучасними фреймворками PHP
• Повністю підтримується в Laravel, Symfony та інших великих екосистемах PHP

Приклад коду: Перелік методів оплати (Payment Method Enum)

enum PaymentMethod: string {  
 case CREDIT_CARD = 'credit_card';  
 case PAYPAL = 'paypal';  
 case BANK_TRANSFER = 'bank_transfer';  

 public function getProcessingFee(): float {  
 return match($this) {  
 self::CREDIT_CARD => 0.029,  
 self::PAYPAL => 0.035,  
 self::BANK_TRANSFER => 0.01  
 };  
 }  
}

Висновок: Оцінюйте потужність переліків (enums) в PHP

Переліки (enums) в PHP — це не просто нова функція, це зміна парадигми в тому, як ми пишемо чистий та підтримуваний код.
Забезпечуючи типову безпеку, чітке призначення та додаткову функціональність, переліки (enums) можуть значно покращити процес розробки на PHP.

Готові підняти свої навички PHP на новий рівень?

• Почніть з простих переліків (enums)
• Переробіть існуючий код, що містить багато констант
• Досліджуйте переліки з підтримкою значень (backed enums) для складніших сценаріїв

Поширені питання про переліки (enums) в PHP

Q: Чи підтримуються переліки (enums) в PHP у всіх версіях?

A: Ні, вони вимагають версії PHP 8.1 або пізнішої.

Q: Чи можна додавати методи до переліків (enums)?

A: Так! Переліки (enums) можуть мати методи, що робить їх неймовірно гнучкими.

Q: Чим переліки (enums) відрізняються від констант?

A: Переліки (enums) забезпечують типову безпеку, можуть мати методи і пропонують більш структурований підхід до визначення набору пов'язаних значень.

Заклик до дії

Ви використовували переліки (enums) в своїх проектах? Поділіться своїм досвідом у коментарях нижче! Хочете дізнатися більше? Перегляньте офіційну документацію PHP про переліки (enums).

Перекладено з: PHP Enums: A Powerful Way to Write Cleaner, More Maintainable Code