mim / dc

触发弃用通知的通用函数和约定

v1.0.0 2021-06-16 13:21 UTC

This package is auto-updated.

Last update: 2024-09-16 20:50:37 UTC


README

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

此包提供了一个名为 trigger_deprecation() 的全局函数,用于触发静默的弃用通知。

通过使用自定义的PHP错误处理器,如由Symfony ErrorHandler组件提供的错误处理器,可以捕获并记录触发的弃用通知,以便稍后发现,无论是在开发环境还是生产环境中。

该函数至少需要3个参数

  • 触发弃用的Composer包的名称
  • 引入弃用的包版本
  • 弃用通知的消息
  • 还可以提供更多参数:它们将使用 printf() 格式化插入到消息中

示例

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

这将生成以下消息:自作者/package 8.9以来:使用"bitcoin"已弃用,请使用"fabcoin"代替。

虽然不一定推荐,但可以通过在应用程序中声明空的 function trigger_deprecation() {} 来完全忽略弃用通知。