在设计 PHP 网页的时候常会因为小小的疏失导致整个网页一片空白,如果没有 PHP 的错误消息的话,要找到问题点会变得十分困难。因此,在网页开发阶段,可以设置 php.ini,让 PHP 显示出错误消息,加速调试(Debug)的效率。

拿以下的 PHP 程序为例:

<html>
    <head>
        <meta charset="UTF-8">
        <title>Magic Len PHP Website</title>
    </head>
    <body>
        <?php
            $arg = $_GET["arg"];
            echo "Input: $arg";
        ?>
    </body>
</html>

以上程序会使用 GET 的方式将参数接在网址(URL)后面传入至 PHP 程序中,然后再显示出来。而且我们预期一定会传入 arg 参数。

如果有传入 arg 参数,就会出现正常的画面,如下:

传入 arg 参数时的正常画面

如果发生未传入 arg 参数等超出预期的情形,可能会导致出现不正常的画面,如下:

未传入 arg 参数时的不正常画面

网页中,Input 文字的右边是空的。究竟 arg 参数是传了空字符串还是根本就没有传入 arg 参数呢?因为在此为了讲解方便,是使用 GET 方法来传递参数,可以直接从网址一探究竟,但如果是使用 POST 方法,就不能直接看到了。

如果可以让 PHP 显示出发生错误消息的行号和错误原因的话,就可以很轻易的解决问题。

让 PHP 显示错误消息

只要打开 PHP 的 display_errors 属性,就可以让 PHP 直接在有问题的网页上显示出错误消息。如果要确认 display_errors 是否有打开,可以使用 phpinfo() 函数,在 PHP 的详细数据表格中,找到 display_errors 项目。

display_errors 若为「Off」表示不显示错误消息。

phpinfo 中 display_errors 为 Off

display_errors 若为 On 表示显示错误消息。

phpinfo 中 display_errors 为 On

要设置 display_errors 属性,可以修改 PHP 设置档 php.ini 的内容,php.ini 的位置可以在 phpinfo 函数产生出来的表格中找到 Loaded Configuration File 项目来查看。接着再使用文字编辑器打开 php.ini,进行编辑即可,通常会需要 root 权限才可以修改 php.ini 的内容。以 Ubuntu Server 18.04 的 LAMP Server 为例,可以使用以下指令来编辑 php.ini。

sudo vim /etc/php/7.2/apache2/php.ini

以 vim 编辑 php.ini 的指令

在 php.ini 内找到 display_errors,将其设置为 On,如下:

display_errors = On

将 display_errors 设为 On

重启 Apache 或 fpm 后,有问题的 PHP 网页就会显示出错误消息了!

PHP 显示未定义索引的 Notice 错误消息

如果 PHP 程序不小心打错,也会告知语法错误,并显示错误行号。

PHP 显示语法错误与错误行号