array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'language.enumerations.examples.php', 1 => 'Beispiele', ), 'up' => array ( 0 => 'language.enumerations.php', 1 => 'Aufzählungen (Enum)', ), 'prev' => array ( 0 => 'language.enumerations.object-differences.inheritance.php', 1 => 'Warum Enums nicht erweiterbar sind', ), 'next' => array ( 0 => 'language.errors.php', 1 => 'Fehler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'language/enumerations.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
Beispiel #1 Grundlegende eingeschränkte Werte
<?php
enum SortOrder
{
case Asc;
case Desc;
}
function query($fields, $filter, SortOrder $order = SortOrder::Asc)
{
/* ... */
}
?>
Die Funktion query()
kann nun mit der Gewissheit
fortfahren, dass $order
garantiert entweder
SortOrder::Asc
oder
SortOrder::Desc
ist. Jeder andere Wert hätte zu einem
TypeError geführt, sodass keine weitere
Fehlerkontrolle oder Prüfung erforderlich ist.
Beispiel #2 Erweiterte exklusive Werte
<?php
enum UserStatus: string
{
case Pending = 'P';
case Active = 'A';
case Suspended = 'S';
case CanceledByUser = 'C';
public function label(): string
{
return match($this) {
static::Pending => 'Pending',
static::Active => 'Active',
static::Suspended => 'Suspended',
static::CanceledByUser => 'Canceled by user',
};
}
}
?>
In diesem Beispiel kann der Status eines Benutzers einer der folgenden
sein: UserStatus::Pending
,
UserStatus::Active
,
UserStatus::Suspended
oder
UserStatus::CancledByUser
. Eine Funktion kann als
Parameter UserStatus
angeben und akzeptiert dann nur
diese vier Werte, Punkt.
Alle vier Werte haben eine label()
-Methode, die eine
von Menschen lesbare Zeichenkette zurückgibt. Diese Zeichenkette ist
unabhängig von der skalaren Zeichenkette "machine name", die z. B. in
der Spalte einer Datenbank oder in einem HTML-Auswahlfeld verwendet
werden kann.
<?php
foreach (UserStatus::cases() as $case) {
printf('<option value="%s">%s</option>\n', $case->value, $case->label());
}
?>