deprecation contracts

Symfony 棄用合約

觸發棄用通知的通用函數和約定。

這個套件提供了一個名為trigger_deprecation()的全域函數，它可以觸發靜默的棄用通知。

透過使用自訂 PHP 錯誤處理程序（例如 Symfony ErrorHandler 元件提供的錯誤處理程序），可以在開發和生產環境中捕獲並記錄觸發的棄用，以供以後發現。

此函數至少需要 3 個參數：

• 觸發棄用的 Composer 套件的名稱
• 引入棄用的包的版本
• 棄用的消息
• 可以提供更多參數：它們將使用printf()格式插入到訊息中

例子：

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

這將產生以下訊息： Since symfony/blockchain 8.9: Using "bitcoin" is deprecated, use "fabcoin" instead.

雖然不推薦，但可以透過在應用程式中聲明空function trigger_deprecation() {}來完全忽略棄用通知。