deprecation contracts

Symfony の非推奨契約

非推奨通知をトリガーするための汎用関数と規約。

このパッケージは、沈黙した非推奨通知をトリガーする、 trigger_deprecation()という名前の単一のグローバル関数を提供します。

Symfony ErrorHandler コンポーネントによって提供されるようなカスタム PHP エラー ハンドラーを使用すると、開発環境と本番環境の両方で、トリガーされた非推奨を捕捉してログに記録し、後で検出することができます。

この関数には少なくとも 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() {}宣言することで、非推奨の通知を完全に無視できます。