symfony / deprecation-contracts
一个通用的函数和约定,用于触发弃用通知
v3.5.0
2024-04-18 09:32 UTC
Requires
- php: >=8.1
This package is auto-updated.
Last update: 2024-09-03 07:09:04 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() {}
来完全忽略弃用通知。