Magento 2 如何在页面启用错误报告
在 Magento 2 中,有时您会遇到这样的问题:出现黑色页面或纯白色页面,并显示错误号,例如错误日志记录号:568837792838 或任何损坏的内容错误。
在 Magento 2 的默认设置中,允许在前端显示错误的功能是禁用的。因此,在今天的帖子中,我将指导您如何在 Magento 2 上显示错误消息或启用错误报告。
如何显示错误:启用错误报告
- 方法 1:重命名 pub/errors/local.xml.sample 文件
- 方法2:编辑.htaccess文件
- 方法3:编辑app/bootstrap.php文件
方法 1:重命名 pub/errors/local.xml.sample 文件
要在浏览器上显示错误,您只需重命名一个 XML 文件即可。但是,如果您在生产环境中,则不建议使用此方法,因此您应该只考虑在开发环境中使用此方法。操作方法如下:
- 首先,转到您的 Magento2 根目录。
- 然后,打开
pub/errors
. - 打开后,您将看到一个名为 的文件
local.xml.sample
。 - 将其从
local.xml.sample
重命名为local.xml
。换句话说,您sample
从文件名中删除了 。 - 最后,
System > Tools > Cache Management
从 Magento 管理员转到刷新缓存。
方法2:编辑.htaccess文件
显示错误的第二种方法是编辑.htaccess file
Magento 2 站点的 。编辑该文件时,您将能够启用 Magento 的开发模式以及 PHP 的错误显示设置。
首先,打开文件.htaccess
并在文件末尾写入以下代码:
php_value display_errors on ## enable PHP's error display settings
php_value error_reporting -1 ## set error display to E_ALL
添加代码后,打开终端/命令提示符并访问 Magento 的根目录。
cd /path/to/your/magento/directory
现在,运行以下命令来激活开发者模式。
php bin/magento deploy:mode:set developer
可以使用以下命令检查当前的部署模式:
php bin/magento deploy:mode:show
最后,使用以下命令清除缓存:
php bin/magento cache:clean
正确执行上述所有步骤后,当您浏览 Magento 网站时,您将看到浏览器本身显示错误。然而,就像第一种方法一样,这仅对开发环境有好处。
方法3:编辑app/bootstrap.php文件
除了编辑.htaccess file
(这是在 Magento 站点上启用错误显示的首选方式)之外,您还可以编辑 PHP 文件。要编辑该文件,请按照以下步骤操作:
- 首先,访问 Magento 的根目录。
- 然后,打开该文件
app/bootstrap.php
。 - 在文件的开头,您将看到以下行代码:
#ini_set('display_errors', 1);
看到后,请将代码更新为:
error_reporting(E_ALL); # Set Error Reporting as E_ALL (Report all PHP errors)
ini_set('display_errors', 1); # Un-commenting this line to enable PHP error display
更新代码后,打开终端/命令提示符,然后转到 Magento 的根目录。
cd /path/to/your/magento/directory
然后,要启用开发者模式,需要运行以下命令
php bin/magento deploy:mode:set developer
如果您想检查当前的部署模式,可以使用以下行:
php bin/magento deploy:mode:show
最后,清除缓存:
php bin/magento cache:clean
就是这样。正确执行上述所有步骤后,您将能够在浏览器上看到错误显示。