Code schreiben, der unter PHP 8.0 läuft #

Diese Seite richtet sich an PHP-Entwickler, die Kernel-Code oder Erweiterungen schreiben, die mit Exponential ausgeliefert werden. Jede solche Datei muss unter PHP 8.0, der ältesten unterstützten Version, und unter 8.5, der neuesten, laufen. Die Regeln sind kurz, und die Werkzeuge prüfen sie, aber die CI führt PHPUnit erst ab 8.1 aus: Unter 8.0 wird Ihr Code nur durch Syntax und Boot geprüft, also machen Sie es gleich beim Schreiben richtig.

Inhalt #

1. Syntax, die Sie nicht verwenden dürfen
2. Funktionen, die neuer als PHP 8.0 sind
3. Argumente, die spätere Versionen hinzugefügt haben
4. Geänderte Standardwerte: HTML-Maskierung
5. Ihren Code prüfen
6. Beispiele aus dem Kernel

Syntax, die Sie nicht verwenden dürfen #

PHP 8.0 kann Folgendes nicht parsen, sodass ein einziges Vorkommen die ganze Datei am Laden hindert:

Attribute wie #[\ReturnTypeWillChange] und #[\Override] sind unter 8.0 harmlos: PHP 8.0 liest sie als Attribute und ignoriert unbekannte.

Funktionen, die neuer als PHP 8.0 sind #

Es gibt zwei Wege, und der Kernel nutzt beide:

1. Eine Funktion, die sich in PHP mit demselben Ergebnis schreiben lässt, kommt in lib/phpcompat.php, innerhalb von if ( !function_exists( '...' ) ). autoload.php lädt die Datei nur, wenn PHP_VERSION_ID < 80100, sodass sie ab 8.1 nicht einmal geöffnet wird und PHPs eigene Funktion läuft. Heute definiert sie array_is_list().

   if ( !function_exists( 'array_is_list' ) )
   {
       function array_is_list( array $array )
       {
           $i = 0;
           foreach ( $array as $key => $unused )
           {
               if ( $key !== $i++ )
                   return false;
           }
           return true;
       }
   }

2. Eine Funktion, die sich nicht in PHP schreiben lässt, wird hinter function_exists() aufgerufen, mit einem Ersatz, der unter 8.0 korrekt ist:

   fflush( $handle );
   if ( function_exists( 'fsync' ) )
       fsync( $handle );

   Der Kernel tut das für fsync() (8.1), memory_reset_peak_usage() (8.2), str_increment() und str_decrement() (8.3) sowie Bildfunktionen wie imageavif().

Argumente, die spätere Versionen hinzugefügt haben #

Eine Funktion, die es unter 8.0 gibt, die aber später einen Parameter bekommen hat, wirft unter 8.0 einen ArgumentCountError, wenn Sie ihn übergeben. Verzweigen Sie nach PHP_VERSION_ID:

if ( PHP_VERSION_ID >= 80100 )
    fputcsv( $handle, $row, ',', '"', '\\', "\r\n" );
else
{
    // PHP 8.0: no $eol parameter; write the line and fix its ending afterwards
}

So schreibt kernel/classes/subitems/expsubitemscsvexport.php CSV unter jeder Version.

Geänderte Standardwerte: HTML-Maskierung #

PHP 8.1 hat die Standard-Flags von htmlspecialchars(), htmlentities(), html_entity_decode() und htmlspecialchars_decode() auf ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 geändert. Der Standard von PHP 8.0 lässt ' unmaskiert, sodass ein Wert in einem HTML-Attribut mit einfachen Anführungszeichen unter 8.0 nicht sicher wäre. Übergeben Sie die Flags immer ausdrücklich:

$html = htmlspecialchars( $value, ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401, 'UTF-8' );

Der Template-Operator wash und 27 weitere Kernel- und Erweiterungsdateien übergeben sie seit 6.0.15, sodass jede Version dieselbe Ausgabe liefert (Ausgaben aus PHP maskieren).

Ihren Code prüfen #

bootsmoke.php lädt die Klassen aus autoload/ezp_kernel.php und der Erweiterungs-Map (ohne die Befehls-, View- und Cronjob-Klassen und die Tests, deren Syntax stattdessen geprüft wird), sodass ein fataler Fehler beim Laden einer Klasse, etwa eine Methodensignatur, die nicht mehr zu ihrer Elternklasse passt, auch ohne einen Test sichtbar wird, der die Klasse verwendet.

Beispiele aus dem Kernel #

Die Arbeit an 6.0.15 hat Folgendes gefunden, und dieselben Fehler sind in Erweiterungen häufig (Unterstützung für PHP 8.0):

Verwandte Seiten #

• Unterstützte PHP-Versionen: 8.0 bis 8.5
• Hinweise zur PHP-8-Migration für Ihren Code
• Entfernte PHP-Funktionen
• Freie Dokumentation: diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.