symfony70/deprecation-contracts

PHP 7.0 对以下内容的支持:一个通用的函数和约定来触发弃用通知

dev-main / 3.1.x-dev 2022-04-22 01:55 UTC

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() {} 来完全忽略弃用通知。