钩子文档

deprecated_file_trigger_error

💡 云策文档标注

概述

deprecated_file_trigger_error 是一个 WordPress 过滤器,用于控制是否在遇到已弃用文件时触发错误。它主要用于调试环境,帮助开发者识别和更新过时的代码。

关键要点

  • 这是一个过滤器,允许修改是否触发已弃用文件的错误。
  • 默认情况下,当 WP_DEBUG 启用时,会触发错误。
  • 参数 $trigger 是一个布尔值,默认为 true,表示触发错误。
  • 在 WordPress 2.5.0 版本中引入。

代码示例

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

注意事项

此过滤器仅在 WP_DEBUG 启用时生效,建议在开发环境中使用以检测已弃用文件。


📄 原文内容

Filters whether to trigger an error for deprecated files.

Parameters

$triggerbool
Whether to trigger the error for deprecated files. Default true.

Source

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

Changelog

Version Description
2.5.0 Introduced.