已停用函数

主题开发人员和插件开发人员以及所有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激活时，插件不能禁止“停用函数提醒”的显示。注意：要在访问者不能访问的页面上显示停用函数。

分类：中文手册