deprecation contracts

Symfony-Ablaufverträge

Eine generische Funktion und Konvention zum Auslösen von Verfallsbenachrichtigungen.

Dieses Paket stellt eine einzelne globale Funktion namens trigger_deprecation() bereit, die stummgeschaltete Verfallsbenachrichtigungen auslöst.

Durch die Verwendung eines benutzerdefinierten PHP-Fehlerhandlers, wie beispielsweise des von der Symfony-ErrorHandler-Komponente bereitgestellten, können die ausgelösten Verwerfungen abgefangen und zur späteren Erkennung protokolliert werden, sowohl in Entwicklungs- als auch in Produktionsumgebungen.

Die Funktion erfordert mindestens 3 Argumente:

• der Name des Composer-Pakets, das die Ablehnung auslöst
• die Version des Pakets, das die veraltete Version eingeführt hat
• die Nachricht der Abwertung
• Es können weitere Argumente angegeben werden: Sie werden mithilfe printf() -Formatierung in die Nachricht eingefügt

Beispiel:

 trigger_deprecation ( ' symfony/blockchain ' , ' 8.9 ' , ' Using "%s" is deprecated, use "%s" instead. ' , ' bitcoin ' , ' fabcoin ' );

Dadurch wird die folgende Meldung generiert: Since symfony/blockchain 8.9: Using "bitcoin" is deprecated, use "fabcoin" instead.

Obwohl dies nicht empfohlen wird, können die Verfallshinweise vollständig ignoriert werden, indem Sie in Ihrer Anwendung eine leere function trigger_deprecation() {} deklarieren.