WordPress停止使用的函数钩子

0条评论

已停用函数

主题开发人员和插件开发人员以及所有WordPress用户都有必要了解WordPress已经停止了哪些函数的使用。

如何开启“停用函数提醒”,用什么钩子来连接已停用的函数,怎样用代码来实现以上两个问题,希望大家能在本文中找到答案。

停用函数提醒

WP_DEBUG在wp-config.php被激活时,会有消息提示说,当前使用了WordPress已停用的函数。而WP_DEBUG被关闭或不存在时,系统就不显示类似提醒报告。

这样只有激活WP_DEBUG的用户才会接到类似消息提醒。接收不到提醒的用户往往意识不到自己需要更新,除非他们下载并激活某个插件。

我们可以将下面这段能够激活WP_DEBUG的代码放入wp-config.php文件:

define('WP_DEBUG', true);

停用的函数/文件动作钩子

每当使用WordPress已停用的函数时,系统会自动调用'deprecated_function_run' 钩子。每当包含某个WordPress已停用的文件时,'deprecated_file_included' 钩子会被调用。这些都是动作钩子,不返回任何值。

若被“钩”上的函数希望记录正运行的某个已停用函数以及运行次数,该钩子函数无法依靠其它工具,只能自己记录。

至于究竟是哪个函数调用了已停用的函数或文件,我们只能利用插件回溯来查看结果。

禁止显示“停用函数提醒”

插件使用以上动作钩子会导致“停用函数提醒”被禁止显示,即使WP_DEBUG处于激活状态。于是我们假设,如果插件同时连接'deprecated_function_run'和deprecated_file_included' 钩子,是不是“停用函数提醒”的显示效果会更好?

要禁止“停用函数提醒”的显示,'deprecated_function_trigger_error' 过滤器钩子需要返回false。要禁止“停用文件提醒”的显示,'deprecated_file_trigger_error' 过滤器钩子需要返回false。

如果插件无法显示已停用的函数或文件,那么WP_DEBUG激活时,插件不能禁止“停用函数提醒”的显示。注意:要在访问者不能访问的页面上显示停用函数。