Entfernte PHP-Funktionen und ihr Ersatz #

Teil 4, Kapitel 6. Eine für PHP 5 geschriebene Erweiterung ruft möglicherweise Funktionen auf, die es nicht mehr gibt. Das Ergebnis ist Call to undefined function, ein fataler Fehler, sobald die Zeile ausgeführt wird. Dieses Kapitel listet die Funktionen auf, die alte Erweiterungen am häufigsten verwenden, die PHP-Version, die sie entfernt hat, und einen Ersatz. Für jede Funktion der ersten Tabelle wurde geprüft, dass sie in PHP 8.0 fehlt.

Sie finden #

grep -rnE '\b(each|create_function|split|spliti|ereg|eregi|ereg_replace|eregi_replace|mysql_[a-z_]+|money_format|get_magic_quotes_gpc|get_magic_quotes_runtime|set_magic_quotes_runtime|fgetss|call_user_method|session_register|mcrypt_[a-z_]+|is_real|hebrevc|convert_cyr_string)\s*\(' --include='*.php' extension/myoldext/

Ein Treffer in einem Kommentar oder in einem String ist harmlos; ein Treffer, dem -> oder :: vorausgeht, ist eine gleichnamige Methode, nicht die PHP-Funktion.

Die Tabelle #

each() #

Das alte Idiom durchläuft ein Array Eintrag für Eintrag:

// before
while ( list( $key, $value ) = each( $array ) )
{
    echo "$key=$value\n";
}

// after
foreach ( $array as $key => $value )
{
    echo "$key=$value\n";
}

Wo die Schleife wirklich vom internen Zeiger des Arrays abhängt (sie macht dort weiter, wo eine frühere Schleife aufgehört hat), behalten Sie den Zeiger bei und ersetzen nur den Aufruf. Das war die Lösung in der Erweiterung birthday bei der Prüfung für PHP 8.0:

<?php
function myOldExtNextPair( array &$array )
{
    $key = key( $array );
    if ( $key === null )
    {
        return false;
    }
    $value = current( $array );
    next( $array );
    return array( $key, $value );
}

create_function() #

create_function() hat mit eval() eine Funktion aus einem String gebaut, und das ist auch der Grund, warum sie entfernt wurde. Ersetzen Sie den String durch eine echte anonyme Funktion:

// before
usort( $nodes, create_function( '$a,$b', 'return strcmp( $a->attribute( "name" ), $b->attribute( "name" ) );' ) );

// after
usort( $nodes, function( $a, $b ) {
    return strcmp( $a->attribute( 'name' ), $b->attribute( 'name' ) );
} );

ereg() und split() #

Aus POSIX-Regulärausdrücken wurden PCRE-Ausdrücke. Fügen Sie Begrenzer hinzu und escapen Sie den Begrenzer, wenn er im Muster vorkommt:

split() mit einem einfachen Trennzeichen war die Lösung in enhancedezbinaryfile bei der Prüfung für PHP 8.0.

Warnung Prüfen Sie, was ereg() zurückgegeben hat, bevor Sie sich auf den Ersatz verlassen. ereg() lieferte die Länge des Treffers oder false; preg_match() liefert 1, 0 oder false. Code, der das Ergebnis mit einer Zahl verglichen hat, muss ein zweites Mal angesehen werden.

mysql_*() #

Eine Erweiterung, die über mysql_query() mit der Datenbank spricht, war schon zu ihrer Zeit falsch: Sie funktionierte nur auf MySQL und nur zufällig auf der Verbindung des Kernels. Exponential 6 unterstützt mehrere Datenbank-Engines, und der Ersatz ist die Datenbankschicht des Kernels, die die Verbindung der Website verwendet:

<?php
$db = eZDB::instance();
$id = (int)$http->postVariable( 'ItemID' );
$name = $db->escapeString( $http->postVariable( 'Name' ) );

$rows = $db->arrayQuery( "SELECT id, name FROM myoldext_item WHERE id = $id" );
$db->query( "UPDATE myoldext_item SET name = '$name' WHERE id = $id" );

Ganzzahlen werden mit (int) umgewandelt, Strings laufen durch escapeString(). Für alles, was über ein paar Abfragen hinausgeht, verwenden Sie stattdessen eZPersistentObject (Persistente Objekte und Ihre eigenen Tabellen). Das ganze Thema steht in Datenbankcode für PHP 8 und jede Engine.

Magic Quotes #

Alter Code hat oft jede Eingabe in eine Prüfung wie diese gepackt:

// before
$value = get_magic_quotes_gpc() ? stripslashes( $_POST['value'] ) : $_POST['value'];

// after
$value = $http->postVariable( 'value' );

Magic Quotes wurden in PHP 5.4 entfernt, der Zweig mit stripslashes() ist also seit über einem Jahrzehnt nicht mehr gelaufen. Lesen Sie Eingaben über eZHTTPTool ($http = eZHTTPTool::instance();), wie es die Module des Kernels bereits tun.

mcrypt #

mcrypt wurde in PHP 7.2 entfernt. Damit verschlüsselte Daten lassen sich mit OpenSSL nur für einige seiner Verschlüsselungsverfahren und Modi entschlüsseln, und nur mit Sorgfalt. Planen Sie diese Änderung gesondert: Schreiben Sie ein einmaliges Skript, das auf einer Installation mit PHP 7.1 mit der alten Methode entschlüsselt und mit sodium_crypto_secretbox() oder openssl_encrypt() neu verschlüsselt. Die Quellen dieses Projekts enthalten keine solche Migration, testen Sie sie also an einer Kopie der Daten.

Wenn eine Bibliothek das Problem ist #

Manchmal steckt die entfernte Funktion in einer Bibliothek von Dritten, die die Erweiterung mitliefert (ein alter PDF-Generator, eine alte Mail-Bibliothek). Patchen Sie die Bibliothek nicht Zeile für Zeile. Suchen Sie nach einem neueren Release derselben Bibliothek oder nach einem gepflegten Ersatz und aktualisieren Sie sie als Ganzes, mit ihrer Lizenz. Halten Sie im Changelog der Erweiterung fest, auf welche Version Sie gewechselt sind und warum.

Verwandte Seiten #

• Zurück: Veraltetes in PHP 8.1 bis 8.5
• Weiter: Konstruktoren alten Stils und statische Aufrufe
• PHP-8.0-Unterstützung
• Entfernte Erweiterungen und SAPIs im PHP-Handbuch
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.