钩子文档

deprecated_class_trigger_error

💡 云策文档标注

概述

deprecated_class_trigger_error 是一个 WordPress 过滤器,用于控制是否在类被弃用时触发错误。它主要用于调试环境,允许开发者自定义错误触发行为。

关键要点

  • 这是一个过滤器钩子,用于管理弃用类时的错误触发。
  • 参数 $trigger 是一个布尔值,默认为 true,表示默认触发错误。
  • 通常与 WP_DEBUG 常量结合使用,仅在调试模式下生效。
  • 在 WordPress 6.4.0 版本中引入。

代码示例

if ( WP_DEBUG && apply_filters( 'deprecated_class_trigger_error', true ) ) {
    // 触发错误的代码逻辑
}

注意事项

此过滤器主要用于开发调试,生产环境中建议保持默认设置或禁用,以避免不必要的错误输出。


📄 原文内容

Filters whether to trigger an error for a deprecated class.

Parameters

$triggerbool
Whether to trigger an error for a deprecated class. Default true.

Source

if ( WP_DEBUG && apply_filters( 'deprecated_class_trigger_error', true ) ) {

Changelog

Version Description
6.4.0 Introduced.