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. |