symfony/deprecation-contracts

一个通用的函数和约定,用于触发弃用通知

v3.5.0 2024-04-18 09:32 UTC

README

一个通用的函数和约定,用于触发弃用通知。

此包提供了一个名为 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() {} 来完全忽略弃用通知。