PHP 8.6 SortDirection: sauberere, sicherere Sorting-APIs für modernes PHP

PHP bietet schon immer mehrere Möglichkeiten, Arrays und Datenstrukturen zu sortieren, aber die APIs waren nicht immer gleich aussagekräftig. Mit PHP 8.6 verbessert das neue SortDirection-Enum die Lesbarkeit und Typsicherheit, wenn Sie aufsteigende oder absteigende Sortierung angeben müssen.

Das ist eine kleine Sprachergänzung, passt aber gut zu einem breiteren Trend in modernem PHP: weg von lose typisierten Flags und magischen Integern hin zu expliziten, selbsterklärenden APIs.

Warum SortDirection wichtig ist

Traditionell stützen sich PHP-Sortierfunktionen auf Flags wie SORT_ASC und SORT_DESC oder auf benutzerdefinierte Vergleichs-Callbacks. Das ist zwar vertraut, aber diese Konstanten sind unter der Haube immer noch nur Integer. Dadurch ist der Code weniger eindeutig, als er sein könnte.

SortDirection gibt Entwicklerinnen und Entwicklern eine klarere Möglichkeit, die Absicht auszudrücken:

• SortDirection::Ascending

• SortDirection::Descending

Dadurch wird Code leichter lesbar, leichter refaktorierbar und weniger anfällig für versehentliche Fehlverwendung.

Ein kurzer Blick auf das neue Enum

In PHP 8.6 können Sie mit dem Enum direkt arbeiten, statt rohe Integer-Flags zu übergeben, wo die API das unterstützt.

Beispiel: SortDirection im Code verwenden

use SortDirection;

function sortUsers(array $users, SortDirection $direction): array
{
    usort($users, function (array $a, array $b) use ($direction): int {
        $comparison = $a['name'] <=> $b['name'];

        return match ($direction) {
            SortDirection::Ascending => $comparison,
            SortDirection::Descending => -$comparison,
        };
    });

    return $users;
}

$users = [
    ['name' => 'Zoe'],
    ['name' => 'Anna'],
    ['name' => 'Mike'],
];

print_r(sortUsers($users, SortDirection::Ascending));
print_r(sortUsers($users, SortDirection::Descending));

Dieses Beispiel zeigt einen der Hauptvorteile des neuen Enums: Die Sortierrichtung ist Teil des Typsystems und nicht nur eine Konvention.

Vergleich mit älteren Ansätzen

Vor SortDirection hätten Sie vielleicht Code wie diesen geschrieben:

function sortUsers(array $users, int $direction): array
{
    usort($users, function (array $a, array $b) use ($direction): int {
        $comparison = $a['name'] <=> $b['name'];

        if ($direction === SORT_DESC) {
            return -$comparison;
        }

        return $comparison;
    });

    return $users;
}

Das funktioniert, hat aber ein paar Nachteile:

• int $direction vermittelt die Bedeutung nicht so klar wie ein Enum

• versehentlich kann jeder beliebige Integer übergeben werden

• die API hängt davon ab, sich zu merken, welche Konstante welchem Verhalten entspricht

Mit SortDirection können Compiler und Runtime dabei helfen, die Absicht klarer auszudrücken.

Praktische Anwendungsfälle

Am meisten profitieren Sie von SortDirection in Code, der Sortierung als konfigurierbare Funktion anbietet, zum Beispiel:

• Admin-Dashboards mit vom Benutzer wählbarer Sortierreihenfolge

• API-Endpunkte mit sort=asc|desc

• wiederverwendbare Collection-Helper

• Sortierlogik in Domain-Services

Beispiel: Request-Eingaben auf SortDirection abbilden

use SortDirection;

function directionFromString(string $value): SortDirection
{
    return strtolower($value) === 'desc'
        ? SortDirection::Descending
        : SortDirection::Ascending;
}

$direction = directionFromString($_GET['direction'] ?? 'asc');

So bleibt die Grenze zwischen Benutzereingaben und interner Logik klar. Zeichenketten werden einmal geparst, danach arbeitet der Rest der Anwendung mit einem stark typisierten Enum.

Besser passend für moderne PHP-Codebasen

Die Einführung von SortDirection wirkt vielleicht bescheiden, passt aber sehr gut zur Entwicklung von PHP in den letzten Versionen:

• mehr Enums

• mehr explizite Typen

• weniger mehrdeutige Konstanten

• klareres Domain-Modelling

Für Teams, die größere Symfony- oder PHP-Anwendungen warten, reduzieren solche Änderungen die kognitive Last. Eine kleine Verbesserung der API-Klarheit kann jedes Mal Zeit sparen, wenn ein zukünftiger Entwickler den Code erneut liest.

Was das für Symfony und das Application Design bedeutet

Auch wenn Ihr Framework-Code SortDirection vielleicht noch nicht direkt anbietet, können Sie das Muster trotzdem in Ihrer eigenen Anwendung übernehmen.

Wenn Sie zum Beispiel einen Symfony-Controller oder Service bauen, der Sortierung verarbeitet, können Sie:

1. einen String aus der Request entgegennehmen

2. ihn validieren und normalisieren

3. ihn in SortDirection umwandeln

4. das Enum in Ihrer Domain- oder Service-Schicht verwenden

Diese Trennung hilft dabei, Controller schlank und Business-Logik lesbar zu halten.

use SortDirection;

final class UserSorter
{
    public function sort(array $users, SortDirection $direction): array
    {
        usort($users, function (array $a, array $b) use ($direction): int {
            $result = $a['createdAt'] <=> $b['createdAt'];

            return $direction === SortDirection::Ascending ? $result : -$result;
        });

        return $users;
    }
}

Diese Art von Code ist leicht zu testen und einfach zu erweitern.

Was Sie beachten sollten

Ein paar praktische Hinweise beim Einsatz des neuen Enums:

• Prüfen Sie Ihre minimale PHP-Version, bevor Sie es verwenden

• halten Sie das Parsing von Eingaben am Rand der Anwendung

• bevorzugen Sie Enums in Ihrer Domain-Logik, auch wenn die externe Schnittstelle noch Strings verwendet

• nutzen Sie match oder explizite Verzweigungen, wenn die Richtung die Business-Logik beeinflusst

Fazit

SortDirection ist eine kleine Ergänzung, folgt aber einem wichtigen Prinzip in modernem PHP: Absichten explizit machen.

Wenn Sie wartbare Anwendungen bauen, insbesondere in Symfony-basierten Codebasen, können Enums wie dieses Ihre APIs klarer und Ihren Code leichter nachvollziehbar machen.

Während sich PHP weiterentwickelt, sind es oft genau diese inkrementellen Verbesserungen, die im Entwickleralltag den größten Unterschied machen.