التعدادات (Enums)

ما هي التعدادات؟

التعداد النقي (Unit Enum)

<?php
enum Status {
    case Active;
    case Inactive;
    case Banned;
}

$s = Status::Active;
echo $s->name; // "Active"

التعداد المرتبط بقيمة

<?php
enum Color: string {
    case Red   = "red";
    case Green = "green";
    case Blue  = "blue";
}

echo Color::Red->value; // "red"

From وTryFrom

<?php
$color = Color::from("red");      // Color::Red
$maybe = Color::tryFrom("purple"); // null

التعدادات في تلميحات الأنواع

<?php
function paint(Color $color): void {
    echo "Painting with ".$color->value;
}
paint(Color::Blue); // "Painting with blue"

حالات التعداد في match

<?php
$label = match($status) {
    Status::Active   => "Active user",
    Status::Inactive => "Inactive account",
    Status::Banned   => "Banned",
};
// PHP can warn if cases are unhandled

التعداد ينفّذ واجهة

<?php
interface HasLabel {
    public function label(): string;
}

enum Status: string implements HasLabel {
    case Active   = "active";
    case Inactive = "inactive";
    public function label(): string {
        return ucfirst($this->value);
    }
}

أساليب التعدادات

<?php
enum Suit: string {
    case Hearts   = "H";
    case Diamonds = "D";
    case Clubs    = "C";
    case Spades   = "S";

    public function color(): string {
        return match($this) {
            Suit::Hearts, Suit::Diamonds => "red",
            Suit::Clubs,  Suit::Spades  => "black",
        };
    }
}

ثوابت التعدادات

<?php
enum Direction {
    case North;
    case South;
    const DEFAULT = self::North;
}

سرد الحالات

<?php
$options = Color::cases();
foreach ($options as $c) {
    echo $c->name.": ".$c->value."\n";
}

التعدادات مقابل ثوابت الفئات

الملخص

تحقّق سريع