故障诊断和报告

如果 Flarum 无法安装或者是没有按照预期运行,第一件需要做的事情就是再次检查你的环境是否达到了系统要求。如果你缺失部分 Flarum 的依赖项(例如 PHP 的 fileinfo 扩展),你将需要先处理这些问题。 接下来,你应该花上几分钟在支持论坛问题追踪器内检索。有可能有人已经汇报了这个问题,或者解决方案正在讨论,或者已经有解决方案。在检索过后,如果你仍然没有发现关于这个问题的信息的话,就是需要进行故障诊断的时候了。

第一步:开启调试模式。

在你处理前,你应该开启 Flarum 的调试模式。仅需使用文本编辑器打开 config.php 文件,将 debug 的值修改为 true。这样,当 Flarum 发生任何错误时,将会显示详细的错误消息。

如果你访问网站时看到一个空白页面,将 PHP 配置文件 php.inidisplay_errors 选项设置为 On。 或者,你也可以将以下代码添加到 flarum/bootstrap.php 文件的开头:

ini_set('display_errors', 'On');

当错误修正后,一定要恢复这些选项!

第二步:复现错误。

试着让错误再发生一次。

Re-translated by @ttnl 17/1/21. First editon translated by @justjavac.