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() {}来完全忽略弃用通知。