symfony70 / deprecation-contracts
PHP 7.0 对以下内容的支持:一个通用的函数和约定来触发弃用通知
dev-main / 3.1.x-dev
2022-04-22 01:55 UTC
Requires
- php: ^7.0 | ^8.0
Replaces
This package is auto-updated.
Last update: 2024-09-22 07:31:30 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');
这将生成以下消息:自从 symfony/blockchain 8.9:使用 "bitcoin" 已弃用,请使用 "fabcoin" 代替。
虽然不推荐这样做,但可以通过在您的应用程序中声明一个空的 function trigger_deprecation() {}
来完全忽略弃用通知。