deprecation contracts

Contrats de dépréciation Symfony

Une fonction générique et une convention pour déclencher des avis de dépréciation.

Ce package fournit une fonction globale unique nommée trigger_deprecation() qui déclenche des avis de dépréciation silencieux.

En utilisant un gestionnaire d'erreurs PHP personnalisé tel que celui fourni par le composant Symfony ErrorHandler, les dépréciations déclenchées peuvent être détectées et enregistrées pour une découverte ultérieure, à la fois dans les environnements de développement et de production.

La fonction nécessite au moins 3 arguments :

• le nom du package Composer qui déclenche la dépréciation
• la version du package qui a introduit la dépréciation
• le message de la dépréciation
• plus d'arguments peuvent être fournis : ils seront insérés dans le message en utilisant le formatage printf()

Exemple:

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

Cela générera le message suivant : Since symfony/blockchain 8.9: Using "bitcoin" is deprecated, use "fabcoin" instead.

Bien que cela ne soit pas recommandé, les avis de dépréciation peuvent être complètement ignorés en déclarant une function trigger_deprecation() {} dans votre application.