作为一名 PHP 开发者，你是否曾经历过这样的情况：代码逻辑看起来完美无缺，但运行结果却是一片空白，或者出现了莫名其妙的 Bug？这往往是因为默认的 PHP 配置隐藏了错误信息。在开发环境中，能够清晰地看到所有错误、警告和提示是至关重要的。
在这篇文章中，我们将深入探讨如何显示 PHP 中的所有错误。我们将不仅局限于最基础的配置，还会带你了解错误报告的工作原理、通过代码动态配置的方法、以及在生产环境中如何安全地处理这些问题。准备好，让我们开始掌握 PHP 错误处理的艺术吧。
为什么错误显示如此重要？
在默认情况下，许多生产环境的 PHP 服务器配置（如 INLINECODEdca23427）为了安全起见，会将 INLINECODE595bd572 设置为 Off。这意味着如果代码出现问题，用户可能只会看到一个空白页（俗称“白屏”），而没有任何线索告诉我们哪里出了问题。
对于开发者而言，这简直是灾难。我们需要看到红色的错误提示，我们需要知道是哪一行代码导致了致命错误，或者是哪个未定义的变量触发了警告。通过配置 PHP 显示所有错误，我们可以：
- 快速定位 Bug：精确到行号的错误信息能极大地缩短调试时间。
- 代码质量检查：通过修复警告和提示，我们可以写出更严谨、更健壮的代码。
- 学习与调试：了解错误的类型有助于我们更深入地理解 PHP 的运行机制。
方法一：使用 error_reporting() 函数
核心概念
最直接的方法是使用 PHP 内置的 error_reporting() 函数。这个函数就像是我们调试时的音量旋钮，它可以控制 PHP 向我们“喊出”多少信息。
error_reporting() 函数主要有两种用法：
- 设置级别：传入一个参数（如
E_ALL），告诉 PHP 只报告特定级别的错误。 - 获取当前级别：不传任何参数，它会返回当前的错误报告级别整数。
在开发环境中，我们的目标是“看到一切”。因此，最常用的设置是 INLINECODE8e603b5a。这里的 INLINECODE56454d41 是一个常量，代表了 PHP 支持的所有错误类型，包括致命错误、警告、提示以及严格的标准建议。
实战代码示例：关闭错误报告（反面教材）
为了理解显示错误的重要性，让我们先看看如果不显示错误会发生什么。我们将错误级别设置为 0，这意味着“闭嘴，什么都不要说”。
输出结果：
无输出
未报告错误
发生了什么？
在这个例子中，我们故意写了一段有问题的代码（INLINECODE834ae6ab）。正常情况下，PHP 应该报错并告诉我们文件不存在。但由于我们将 INLINECODE2d52dbe7 设置为了 0，PHP 忽略了一切。这就是我们在生产环境中遇到“白屏”时最常见的原因——错误被隐藏了。
实战代码示例：显示所有错误（E_ALL）
现在，让我们把音量调到最大。我们将使用 E_ALL 来显示所有可能的错误。
输出结果：
PHP Notice: Use of undefined constant gfg - assumed ‘gfg‘ in
/user/code/example.php on line 6
PHP Notice: Use of undefined constant php - assumed ‘php‘ in
/user/code/example.php on line 6
PHP Warning: include(gfgphp): failed to open stream: No such file or directory in
/user/code/example.php on line 6
深度解析：
看，这就是我们要的真相！输出信息揭示了三层问题：
- PHP Notice (提示)：INLINECODEdcb6f53e。这是因为我们在 INLINECODEbbc08d95 时没有给 INLINECODE2c2e90c6 加上引号。PHP 首先寻找名为 INLINECODE4968c448 的常量，找不到时把它当成裸字符串
gfg。这是一个非常典型的逻辑错误，如果不显示出来，可能会导致很难排查的漏洞。 - PHP Warning (警告)：
failed to open stream。这才是真正的问题核心——文件找不到。
通过开启 E_ALL，我们不仅发现了致命的错误，还顺便修复了代码风格问题（总是给字符串加上引号）。
实战代码示例：仅显示未声明变量（E_NOTICE）
有时候，我们只关心特定类型的错误。例如，在代码审查中，你可能只想找出所有未声明的变量。我们可以使用 E_NOTICE。
输出结果：
Notice: Undefined variable: myVar in /user/code/example.php on line 6
Notice: Use of undefined constant gfg - assumed ‘gfg‘ in /user/code/example.php on line 9
Notice: Use of undefined constant php - assumed ‘php‘ in /user/code/example.php on line 9
关键点：
请注意，上面的输出中没有出现 INLINECODEc9eaac6a。为什么？因为 INLINECODE5518da15 只拦截“提示”级别的信息，而“文件包含失败”属于 Warning 级别。这个例子非常有助于我们理解错误级别的层级关系。
实战代码示例：排除提示（~E_NOTICE）
在实际开发中，有些开发者觉得 INLINECODE0fb75c48 太吵了（比如告诉你数组下标未定义），只想看严重的错误，我们可以使用位运算符 INLINECODEf651ccb3（非）来排除特定的级别。
输出结果：
Warning: include(gfgphp): failed to open stream: No such file or directory in
/user/code/example.php on line 6
Warning: include(): Failed opening ‘gfgphp‘ for inclusion (include_path=‘...‘) in
/user/code/example.php on line 6
解析：
在这个结果中，关于 INLINECODE874a747a 和 INLINECODEfc6aaa60 常量未定义的 INLINECODE37e5fbe9 消失了，只留下了关键的 INLINECODE0c456065。这通常是在旧项目维护中一种折中的方案，但我们建议你在新项目中尽量修复所有的 Notice，以保持代码的纯净。
方法二：通过配置文件 php.ini 与 htaccess
虽然 error_reporting() 函数很灵活，但它只对当前执行的脚本生效。如果我们想在整个服务器或整个目录范围内全局开启错误显示，最好的办法是修改配置文件。
全局配置：php.ini
php.ini 是 PHP 的核心配置文件。要显示所有错误，你需要找到并修改以下两个指令：
- display_errors：控制是否将错误直接输出到屏幕。
- displaystartuperrors：控制是否显示 PHP 启动过程中的错误。
在你的 php.ini 文件中，找到这几行（或者手动添加）：
; 将其设置为 On 以显示错误
;display_errors = Off
;display_startup_errors = Off
; 修改为以下内容：
display_errors = On
display_startup_errors = On
``
**注意：** 修改 `php.ini` 后，必须重启 Web 服务器（如 Apache 或 Nginx）才能生效。
### 局部配置：.htaccess 文件
如果你使用的是 Apache 服务器，并且没有权限修改 `php.ini`（例如在共享主机上），你可以通过项目根目录下的 `.htaccess` 文件来覆盖设置。这是一种非常优雅的解决方案，因为它不会影响服务器上的其他项目。
在你的 `.htaccess` 文件中添加以下内容：
apache
phpvalue displayerrors 1
phpvalue displaystartup_errors 1
phpvalue errorreporting E_ALL
这种方法特别适合用于多环境配置切换，比如你可以为“开发环境”和“生产环境”准备不同的配置文件。
## 方法三：在运行时动态修改配置
如果你无法修改服务器配置文件，或者只想在特定页面开启调试，可以使用 `ini_set()` 函数。这是调试遗留代码时的“秘密武器”。
php
<?php
// 在脚本运行时动态修改配置
// 强制显示错误到屏幕
iniset(‘displayerrors‘, 1);
// 同样显示启动错误
iniset(‘displaystartup_errors‘, 1);
// 设置报告所有错误
errorreporting(EALL);
// 测试代码
echo $undefinedVariable;
?>
“INLINECODEb1369298index.phpINLINECODEe76c9bf5displayerrorsINLINECODE46a95e25OffINLINECODE44aa5335ENOTICEINLINECODE26aec623isset()INLINECODEd306237adisplayerrorsINLINECODE79644d68logerrorsINLINECODE699e94afWarningINLINECODEdbff313eNoticeINLINECODE5440c3e5errorreporting()INLINECODE195b9625EALLINLINECODE1739ced6php.iniINLINECODEb0026b4b.htaccessINLINECODEff5ffef6inisetINLINECODE72fc2bb3displayerrorsINLINECODE1f7cad80errorreporting(EALL)`，看看能发现多少被忽视的潜在问题。
- 配置日志系统，让你的调试过程更加专业和高效。