WordPress调式模式介绍
WP_DEBUG 是一个布尔常量,它在整个 WordPress中触发“调试”模式。其位于WordPress安装根目录wp-config.php中。 一般来说,我们在开发WordPress 主题的时候,都会开启WordPress的Debug 模式(调试模式),以便检测出主题是否存在bug;对于新手来说是不需要开启的,但如果在启动主题的后,前端页面显示存在问题、后台无法显示、出现404、500错误提示等情况时,巧用Debug调试模式,即可查看到底错误出现哪里。
WP_DEBUG 是一个PHP常量(永久全局变量),可用于在整个WordPress中触发“调试”模式。默认情况下,它假定为false,并且通常在WordPress的开发副本上的(wp-config-sample)文件中设置为true 。
找到“ WP_DEBUG ”其值在“wp-config.php”文件大概82行左右:
* For information on other constants that can be used for debugging, * visit the documentation. * * @link https://wordpress.org/support/article/debugging-in-wordpress/ */ define( 'WP_DEBUG', false ); /* Add any custom values between this line and the "stop editing" line. */
开启调试模式只需要将false修改成true保存修改。当设置为“true”时,您将开始看到PHP通知没有那么多错误,因为它们对于开发人员来说是有用的消息 - 以及WordPress生成的调试消息,特别是已弃用的功能使用,显示在您网站的页面上。许多WordPress版本中包含的不推荐使用的函数是已被标记为在以后死亡的函数。重要的是要知道您是否在正在使用的主题或插件中使用已弃用的功能,以便您可以找到替代使用的替代品。
请注意:
WP_DEBUG 不应在实际站点上使用,这一点很重要 。虽然它在开发过程中是一个有用的功能,但它在现场网站上可能会很危险,因为PHP通知中的文本可以向您网站的访问者显示有关您的代码,路径和其他信息的详细信息。
WP_DEBUG_DISPLAY
使用WP_DEBUG_DISPLAY关闭在您的站点上显示错误,如果您不希望将错误消息发布到您网站的页面,则应使用WP_DEBUG_DISPLAY。这是另一个有用的常量,它允许您控制调试消息是否显示在站点的HTML中。
默认值为“true”,显示生成时的错误和警告。将其更改为“false”将隐藏所有错误。此常量应与WP_DEBUG_LOG一起使用。要使用他的功能,只需将以下代码行添加到wp-config.php文件中:
define('WP_DEBUG_DISPLAY',false);
WP_DEBUG_LOG
Debug.log文件位于站点的/ wp-content /目录中的debug.log错误日志。您可以通过SSH,FTP或cPanel中的文件管理器访问此目录。如果您想打开调试并记录错误消息但隐藏您网站上显示的通知,则可以轻松地将所有三个常量一起使用:
// Turn debugging on define('WP_DEBUG', true); // Tell WordPress to log everything to /wp-content/debug.log define('WP_DEBUG_LOG', true); // Turn off the display of error messages on your site define('WP_DEBUG_DISPLAY', false); // For good measure, you can also add the follow code, which will hide errors from being displayed on-screen @ini_set('display_errors', 0);