mim / dc
触发弃用通知的通用函数和约定
v1.0.0
2021-06-16 13:21 UTC
Requires
- php: >=7.1
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() {}
来完全忽略弃用通知。