如何配置Ubuntu PHP错误处理

在Ubuntu系统中配置PHP错误处理

想让你的Ubuntu服务器上的PHP应用更稳定、调试更高效？正确配置错误处理是关键一步。这事儿其实不复杂，核心就是调整那个php.ini配置文件。下面，咱们就一步步来，把它搞定。

1. 找到php.ini文件

首先，得把主角请出来。你的PHP配置文件php.ini通常藏在以下几个地方：

• /etc/php/7.x/cli/php.ini （这是给命令行脚本用的）
• /etc/php/7.x/apache2/php.ini （搭配Apache服务器时用这个）
• /etc/php/7.x/fpm/php.ini （如果你用的是Nginx加PHP-FPM这套组合拳）

要是记不清具体路径，别担心，一个命令就能让它现身：

php --ini

2. 备份php.ini文件

老规矩，动手修改前先备份。这步可不能省，万一调乱了，还能有个后悔药吃。执行下面这行命令就行：

sudo cp /etc/php/7.x/cli/php.ini /etc/php/7.x/cli/php.ini.bak

3. 编辑php.ini文件

接下来，用你顺手的文本编辑器打开它。nano简单直接，vim高手最爱，选哪个都行。比如：

sudo nano /etc/php/7.x/cli/php.ini

4. 配置错误处理

打开文件后，找到下面这几个关键配置项，它们就是控制PHP错误行为的“开关”。

错误报告级别

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT

这行配置决定了PHP该“揪出”哪些类型的错误。设置成E_ALL & ~E_DEPRECATED & ~E_STRICT，意思是报告所有错误，但放过那些关于未来版本不兼容的弃用警告（~E_DEPRECATED）和编码规范建议（~E_STRICT）。这在开发阶段非常有用，能帮你发现绝大多数问题。

显示错误

display_errors = Off

这个开关要特别注意。它控制是否直接把错误信息打印到用户的浏览器上。记住一个铁律：在生产环境，务必把它设为Off。否则，不仅用户体验糟糕，还可能把数据库结构、路径等敏感信息暴露给访客，引来安全风险。

记录错误日志

log_errors = On
error_log = /var/log/php_errors.log

既然不在页面上显示，错误去哪了？答案是日志文件。把log_errors设为On，然后通过error_log指定一个路径（比如/var/log/php_errors.log），所有错误就会被安静地记录在那里，方便你随时查阅分析。

自定义错误处理函数

如果默认的记录方式满足不了你，PHP还允许你完全接管错误处理流程。用set_error_handler函数注册一个自己的函数就行，想怎么记、记到哪里、甚至要不要转换错误类型，都由你说了算。下面是个简单例子：

function custom_error_handler($errno, $errstr, $errfile, $errline) {
    // 这里就是你的地盘：可以记录到数据库、发送告警邮件等等
    echo "Error: [$errno] $errstr on line $errline in $errfile";
    return true; // 返回true，告诉PHP：“这个错误我处理了，你不用管了”
}
set_error_handler("custom_error_handler");

5. 保存并退出编辑器

所有配置调整完毕后，保存文件，退出编辑器。在nano里，通常是按Ctrl+X，然后按Y确认，再按回车。

6. 重启Web服务器或PHP-FPM服务

配置改了，得让服务重新加载一下才能生效。根据你的服务器软件，重启对应的服务：

Apache

sudo systemctl restart apache2

Nginx + PHP-FPM

sudo systemctl restart php7.x-fpm
sudo systemctl restart nginx

7. 验证配置

最后一步，验收成果。创建一个简单的测试PHP脚本：

在浏览器中访问这个脚本。如果一切配置正确，你应该不会在页面上看到详细的错误堆栈（因为display_errors关了），但同时，你去查看指定的日志文件/var/log/php_errors.log，里面应该已经清晰地记录下了这条测试错误信息。

走完这七步，你的Ubuntu系统上的PHP错误处理机制就配置妥当了。这套组合拳打下来，既能保障线上环境的安全与清净，又能确保开发调试时信息完备，可谓一举两得。