Web & Entwicklung

PHP 8.6: Neue Funktionen, veraltete Funktionen und ein praktischer Migrationsleitfaden

PHP 8.6: New Features, Deprecated Functions, and a Practical Migration Guide

Aktualisieren Sie auf PHP 8.6 mit Vorher- und Nachher-Beispielen für veraltete PHP-Funktionen, MySQLi, mbstring, CSV, Sessions und einer praktischen Migrationscheckliste.

PHP 8.6.0 wurde am 19. November 2026 veröffentlicht. Die Hauptfunktionen sind interessant, aber für Entwickler, die echte Websites pflegen, lautet die dringende Frage oft anders: Welche Zeilen des bestehenden Codes beginnen, Deprecation-Hinweise auszugeben, und wie sollten sie umgeschrieben werden?

Dieser Leitfaden stellt die Migrationsarbeit in den Vordergrund. Jedes Beispiel identifiziert eine veraltete API, zeigt eine Alternative und hebt hervor, wo ein mechanisches Suchen-und-Ersetzen gefährlich wäre. Ein Deprecation-Hinweis ist nicht dasselbe wie ein unmittelbarer fataler Fehler: Er warnt davor, dass Code Aufmerksamkeit benötigt, oft bevor eine zukünftige Hauptversion die API entfernt.

PHP 8.6 Migrationspfad: Inventar, Staging, Logs, Korrekturen und Regressionstests

1. Prüfen Sie Ihre Laufzeitumgebung, bevor Sie die Produktion anfassen

Führen Sie diese Befehle in derselben PHP-Umgebung aus, die die Anwendung bereitstellt (CLI und Web-PHP können unterschiedliche Binärdateien und Einstellungen verwenden):

php -v
php -m
php --ini

Prüfen Sie die vom Projekt verwendeten Erweiterungen, insbesondere mbstring, mysqli und intl. Vergewissern Sie sich, dass das Framework, das CMS, die Erweiterungen und die Hosting-Umgebung PHP 8.6 ausdrücklich unterstützen; schließen Sie nicht allein daraus, dass eine Website startet, auf Kompatibilität.

In einer Staging-Umgebung protokollieren Sie alle Fehler und halten dabei Diagnosemeldungen aus dem öffentlichen HTML heraus:

<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');

Diese Laufzeiteinstellungen sind für einen kontrollierten Test nützlich. Ziehen Sie es vor, die Protokollierung auf Serverebene für langlebige Umgebungen zu konfigurieren; stellen Sie sicher, dass das Fehlerprotokoll beschreibbar und privat ist. Eine Deprecated-Meldung ist auch dann umsetzbar, wenn die Seite noch gerendert wird.

2. Kurzreferenz: veraltete APIs und was stattdessen zu verwenden ist

In PHP 8.6 veraltet Empfohlener Ansatz Migrationshinweis
is_integer(), is_long() is_int() Direkte Aliase
is_double() is_float() Direkter Alias
doubleval() floatval() Direkter Alias
spl_object_hash() spl_object_id() Rückgabetyp ändert sich von string zu int
mb_ereg(), mb_eregi() preg_match() Pattersyntax und Unicode-Flags anpassen
mb_ereg_replace() preg_replace() Escaping, Ersetzungssemantik und Fehler prüfen
mysqli_stmt_init() mysqli_prepare() Sofort vorbereiten
mysqli_get_charset() mysqli_character_set_name() Nur wenn der Zeichensatzname benötigt wird
SplFileObject::fgetcsv() fgetcsv() auf einem Stream Stream-Position und CSV-Einstellungen überprüfen
SplFileObject::fputcsv() fputcsv() auf einem Stream Trennzeichen, Anführungszeichen und Escape explizit übergeben
strcoll() Collator::compare() Erfordert intl; ein Gebietsschema wählen
SORT_LOCALE_STRING Collator::sort() / asort() Gebietsschema-Verhalten kann sich ändern
spl_classes() ReflectionExtension::getClassNames() Die entsprechende Erweiterung untersuchen
Drittes Argument von define() Das Argument weglassen Der alte Groß-/Kleinschreibungs-ignorierende Modus ist weg
return in finally Außerhalb von finally zurückgeben Das Unterdrücken von Ausnahmen vermeiden
Objekt, das an array_walk() übergeben wird Zuerst get_object_vars() Änderungen per Referenz mutieren das Objekt möglicherweise nicht mehr
metaphone() Eine gepflegte phonetische Implementierung Kein Drop-in-Ersatz im Core

Manche APIs haben keinen exakten Ersatz. Die korrekte Migration erfordert möglicherweise eine Änderung des Designs statt der Umbenennung einer Funktion. Siehe die offizielle Liste der PHP-8.6-Deprecations.

3. Einfache Aliase: sichere, schnelle Korrekturen

Vorher — veraltet:

<?php
if (is_integer($quantity) && is_double($price)) {
    $total = doubleval($price) * $quantity;
}

Nachher:

<?php
if (is_int($quantity) && is_float($price)) {
    $total = floatval($price) * $quantity;
}

Die Aliase haben dieselbe Semantik. Gehen Sie nicht davon aus, dass is_float(40) true ist: Eine Ganzzahl bleibt eine Ganzzahl. Dieses Verhalten war bereits vor der Migration vorhanden.

Für einen String-Betrag ist floatval() eine Konvertierung, keine geldsichere Dezimaldarstellung. Behalten Sie die bestehende Geldverarbeitungsstrategie des Projekts bei, statt sie als Teil eines nicht damit zusammenhängenden PHP-Upgrades zu ändern.

4. Migration von mbstring-Regular Expressions

Die mb_ereg*-Familie ist veraltet, weil ihre zugrunde liegende Oniguruma-Regex-Engine nicht mehr gepflegt wird. PHP empfiehlt PCRE für viele Anwendungsfälle, aber die Pattern-Dialekte sind nicht identisch.

Vorher:

<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;

Nachher (nur ASCII-Ziffern):

<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;

Hier bewirkt der Modifikator D, dass $ nur am Ende des Subjekts übereinstimmt. Für Unicode-Text verwenden Sie ein passendes UTF-8-Pattern und den Modifikator u:

<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;

Vorher — Ersetzung:

<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);
Illustration of the article's main concept

Nachher — Ersetzung:

<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
    throw new RuntimeException('Regular expression failed');
}

Die beiden Patterns können sich bei manchem Unicode-Leerraum unterscheiden. Testen Sie für echte Migrationen Zeichen mit Akzenten, Zeilenumbrüche, ungültiges UTF-8, Erfassungsgruppen und Rückverweise anhand der tatsächlichen Projektdaten. Ersetzen Sie nicht pauschal jeden mb_ereg-Aufruf, ohne den Ausdruck zu prüfen.

5. MySQLi: eine Anweisung in einem Schritt vorbereiten

Vorher — veraltet:

<?php
$stmt = mysqli_stmt_init($mysqli);
mysqli_stmt_prepare($stmt, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);

Nachher:

<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);

Verwenden Sie bei der objektorientierten API $mysqli->prepare($sql) anstelle von $mysqli->stmt_init() gefolgt von prepare(). Behalten Sie Ihre bestehende Fehlerbehandlung bei und schließen Sie Anweisungen angemessen.

Die separate mysqli_get_charset()-API ist ebenfalls veraltet. Wenn Sie nur den aktuellen Zeichensatznamen benötigen:

<?php
$charsetName = mysqli_character_set_name($mysqli);

Dies ist kein Ersatz für alle Felder des alten Zeichensatz-Informationsobjekts. Wenn der Code von Collation-Metadaten abhängt, untersuchen Sie, was er tatsächlich benötigt, und fragen Sie den Server entsprechend ab.

6. CSV: veraltete SplFileObject-CSV-Methoden ersetzen

Die CSV-spezifischen Methoden auf SplFileObject sind veraltet. Verwenden Sie für neuen und migrierten Code die streambasierten Funktionen fgetcsv() und fputcsv().

Vorher:

<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
    $row = $file->fgetcsv();
    // Process row
}

Nachher:

<?php
$handle = fopen($path, 'rb');
if ($handle === false) {
    throw new RuntimeException('Cannot open CSV file');
}
try {
    while (($row = fgetcsv($handle, 0, ',', '"', '')) !== false) {
        // Process row
    }
} finally {
    fclose($handle);
}

Das leere Escape-Argument deaktiviert den proprietären Escape-Mechanismus von PHP; testen Sie diese Entscheidung gegen das Format, das Ihr Quellsystem exportiert. Prüfen Sie Leerzeilen, Kopfzeilen, Trennzeichen, eingebettete Zeilenumbrüche und die Kodierung. Dieses Beispiel veranschaulicht die API-Änderung, nicht einen universellen CSV-Parser.

Verwenden Sie zum Schreiben fputcsv($handle, $fields, ',', '"', ''). Behalten Sie den erwarteten Dialekt der ursprünglichen Datei bei.

7. Objektidentität: spl_object_hash() ist kein Inhalts-Hash

Vorher:

<?php
$key = spl_object_hash($object);

Nachher:

<?php
$key = spl_object_id($object);

Die Alternative gibt eine Ganzzahl zurück, keinen String. Wenn Schlüssel serialisiert, in einer Datenbank gespeichert oder über eine API exponiert werden, prüfen Sie zuerst die Konsumenten. Keine der beiden Funktionen erzeugt einen persistenten Identifikator über Anfragen hinweg, und IDs können nach der Zerstörung von Objekten wiederverwendet werden. Für eine Map, die nach der Identität lebender Objekte geschlüsselt ist, ziehen Sie SplObjectStorage oder WeakMap in Betracht, je nach Anforderungen an die Lebensdauer.

8. Ein return in finally kann Fehler verbergen

Vorher — veraltet und irreführend:

<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        return []; // Overrides the result and hides exceptions
    }
}

Nachher — Bereinigung ohne Überschreiben des Ergebnisses beibehalten:

Technical workflow illustration
<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        releaseTemporaryResources();
    }
}

Wenn der ursprüngliche Code bewusst einen Fallback zurückgab, verschieben Sie diese Entscheidung in einen catch-Block mit expliziter Behandlung. Unterdrücken Sie nicht stillschweigend eine Ausnahme, die den Aufrufer erreichen sollte.

9. Gebietssschemaabhängige Sortierung und andere weniger offensichtliche Änderungen

strcoll() und das Sortier-Flag SORT_LOCALE_STRING sind veraltet. Die empfohlene intl-Alternative ist Collator:

<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);

Stellen Sie sicher, dass intl installiert ist. Gebietssschemaabhängige Sortierung ist eine Geschäftsregel: Testen Sie Ihre erwartete Reihenfolge, statt anzunehmen, dass ICU und ein prozessglobales Gebietsschema sich immer identisch verhalten.

Andere Migrationsaspekte verdienen ausdrückliche Aufmerksamkeit:

  • ArrayIterator: Sortier-, Flag- und Serialisierungsmethoden wie asort(), ksort(), setFlags() und serialize() sind veraltet. Sortieren Sie das zugrunde liegende Array oder verwenden Sie ArrayObject, wenn dessen API passend ist; gehen Sie nicht davon aus, dass ein Iterator und ein Container austauschbar sind.
  • Benutzerdefinierte Session-Handler: Implementieren Sie sowohl create_sid() als auch validateId(), wie es die aktualisierten Schnittstellen/das Verhalten erfordern. PHP 8.6 aktiviert strengere Session-Standardeinstellungen; testen Sie Anmeldung, Session-Rotation und Persistenz.
  • __debugInfo(): Verwenden Sie einen nicht-nullable array-Rückgabetyp; das Zurückgeben von null war bereits veraltet.
  • define(): Entfernen Sie das dritte case_insensitive-Argument, auch wenn es false ist.
  • http_build_query() und array_walk(): Das Übergeben von Objekten, wo Arrays erwartet werden, ist veraltet. Konvertieren Sie bewusst mit get_object_vars() oder erstellen Sie das gewünschte Array explizit.
  • metaphone(): Es existiert kein gleichwertiger, eingebauter PHP-Ersatz. Wählen und testen Sie einen gepflegten, sprachlich passenden phonetischen Algorithmus.
  • Reservierte Bezeichner: Namen wie let, is, readonly (Funktion) und namespace (Klassenkonstante) haben neue Deprecation-Beschränkungen. Benennen Sie betroffene Deklarationen sorgfältig um.
  • Reflection: Prüfen Sie ungültige Objekte, die an ReflectionProperty::setValue() übergeben werden, und Objektargumente, die beim Aufruf statischer Methoden übergeben werden.

Konsultieren Sie den vollständigen Migrationsleitfaden für Randfälle, die in dieser praktischen Auswahl nicht behandelt werden.

10. Veraltete Aufrufe in einem bestehenden Projekt finden

Beginnen Sie mit einem schreibgeschützten Inventar. Unter Linux oder macOS:

grep -RnE --include='*.php' \
  'is_integer\(|is_long\(|is_double\(|doubleval\(|spl_object_hash\(|mb_ereg\(|mb_ereg_replace\(|mysqli_stmt_init\(|mysqli_get_charset\(' \
  ./src

Ersetzen Sie ./src durch das tatsächliche Verzeichnis. Diese Textsuche kann Kommentare oder Strings treffen und übersieht dynamische Aufrufe, namensraumbezogene Aliase und andere veraltete APIs. Sie ist ein Ausgangspunkt, kein vollständiger statischer Analyzer.

Für eine plattformübergreifende Option kann die Funktion „In Dateien suchen" eines Editors nach denselben Namen suchen. Bearbeiten Sie keine Vendor- oder CMS-Core-Dateien direkt: Aktualisieren Sie das Upstream-Paket oder reichen Sie einen Patch bei dessen Maintainer ein.

Ein sicherer PHP-8.6-Migrationsworkflow mit Staging, Log-Überprüfung und Regressionstests

Eine reproduzierbare Migrationsabfolge

  1. Notieren Sie die aktuelle PHP-Version und die aktivierten Erweiterungen.
  2. Sichern Sie Dateien und Datenbank; bereiten Sie eine Staging-Kopie vor.
  3. Führen Sie das Projekt unter PHP 8.6 mit aktivierter Deprecation-Protokollierung aus.
  4. Inventarisieren Sie Warnungen nach Datei und Zeile und gruppieren Sie dann nach API.
  5. Korrigieren Sie First-Party-Code mit gezielten Änderungen; aktualisieren Sie Drittanbieter-Abhängigkeiten separat.
  6. Führen Sie Unit-/Integrationstests und wichtige Benutzerabläufe erneut aus.
  7. Prüfen Sie Formulare, Anmeldung, Sessions, E-Mail, Zahlungen, geplante Jobs, CSV-Import/Export und Datenbankzugriff.
  8. Stellen Sie mit einem Rollback-Plan bereit; überwachen Sie nach der Veröffentlichung die Fehlerprotokolle.

Joomla und WordPress: Dass PHP 8.6 veröffentlicht wurde, bedeutet nicht, dass jede CMS-Version, Erweiterung oder jedes Plugin es unterstützt. Bestätigen Sie die Kompatibilität mit den konkret eingesetzten Versionen und testen Sie zuerst eine Staging-Umgebung. Nutzen Sie das Upgrade nicht als Grund, Core- oder Vendor-Code direkt zu patchen.

11. Was ist in PHP 8.6 tatsächlich neu?

Über die Deprecations hinaus fügt die Version mehrere Sprach- und Laufzeitfunktionen hinzu:

Funktion Praktischer Nutzen
Partielle Funktionsanwendung Argumente vorbefüllen und ein Callable für die verbleibenden erhalten
clamp() Einen Wert zwischen einem Minimum und einem Maximum eingrenzen
\Time\Duration Verstrichene Zeit statt eines Kalenderdatums darstellen
SortDirection Auf-/absteigende Richtung über ein standardisiertes Enum ausdrücken
Io\Poll Stream-Polling in Event-Loop- und I/O-Bibliotheken unterstützen
Standards für readonly-Eigenschaften Ausgewählte unveränderliche Klassendeklarationen vereinfachen

Ein kleines, sofort nützliches Beispiel ist clamp():

<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));

// PHP 8.6
$percentage = clamp($input, 0, 100);

Der Code ist leichter lesbar, aber die Migrations-Priorität sollte weiterhin der Kompatibilitätstest sein. Die anderen Funktionen sind nicht notwendig, um eine bestehende Anwendung am Laufen zu halten. Siehe die offizielle Versionsankündigung.

12. Bevor Sie die Produktions-PHP-Version umstellen

Behandeln Sie PHP 8.6 als kontrolliertes Upgrade, nicht als einen Knopf, den man auf einem stark ausgelasteten Produktionsserver drückt. Eine sinnvolle Release-Checkliste ist: unterstütztes CMS und Abhängigkeiten; verfügbare Erweiterungen; keine unerwartete Deprecation-Flut; bestandene Tests; verifiziertes Datenbank- und Session-Verhalten; getestete Backups; und ein Rollback-Verfahren.

Fazit: PHP 8.6 bringt nützliche Funktionen, aber seine Deprecations sind oft der Punkt, an dem die Wartungsarbeit beginnt. Korrigieren Sie zuerst die einfachen Aliase und testen Sie dann verhaltensbezogene Migrationen — insbesondere Regex, CSV, Sessions und gebietssschemaabhängige Operationen — anhand realer Daten.

Offizielle Quellen