PHP作为常用的服务端脚本语言，在运行过程中难免会出现各类错误，掌握正确的错误处理和调试方法，是开发者必备的技能。合理的错误处理不仅能让程序更健壮，还能帮助快速定位问题根源。
PHP常见错误类型
PHP的错误按照严重程度和触发场景，主要分为以下几类：
- 语法错误：代码不符合PHP语法规范，比如少写分号、括号不匹配，这类错误会在解析阶段直接抛出，脚本无法运行。
- 运行时错误：代码语法正确，但在运行过程中触发的问题，比如调用不存在的函数、访问未定义的变量，这类错误可能导致脚本中断或部分逻辑无法执行。
- 警告错误：不会中断脚本执行，但提示存在潜在问题，比如包含不存在的文件、参数类型不匹配。
- 通知错误：程度最轻的错误，通常是访问未初始化的变量、使用未定义的常量等，脚本会继续运行。
PHP内置错误处理机制
1. 错误报告级别配置
可以通过error_reporting函数或者php.ini配置来设置脚本需要报告的错误类型，常用的级别如下：
| 错误级别常量 | 说明 |
|---|---|
| E_ALL | 报告所有错误和警告 |
| E_ERROR | 报告致命运行时错误 |
| E_WARNING | 报告运行时警告 |
| E_NOTICE | 报告运行时通知 |
| E_PARSE | 报告编译时语法解析错误 |
在开发环境可以设置报告所有错误，方便排查问题：
<?php
// 报告所有错误
error_reporting(E_ALL);
// 开启错误显示
ini_set('display_errors', 1);
?>2. 自定义错误处理函数
使用set_error_handler可以注册自定义的函数来处理非致命错误，替代PHP默认的错误提示：
<?php
// 自定义错误处理函数
function custom_error_handler($errno, $errstr, $errfile, $errline) {
$error_msg = "错误级别：{$errno} | 错误信息：{$errstr} | 文件：{$errfile} | 行号：{$errline}";
// 可以将错误记录到日志文件
error_log($error_msg, 3, 'error.log');
// 如果是致命错误之外的错误，可以选择不中断脚本
if ($errno != E_USER_ERROR) {
return true;
}
// 致命错误时终止脚本
die("发生致命错误，程序终止");
}
// 注册自定义错误处理函数
set_error_handler("custom_error_handler");
// 触发一个警告错误测试
echo $undefined_var;
?>3. 异常处理
PHP的异常需要手动抛出才能捕获，结合try-catch块可以处理预期内的错误场景：
<?php
function divide($a, $b) {
if ($b == 0) {
throw new Exception("除数不能为0");
}
return $a / $b;
}
try {
$result = divide(10, 0);
echo $result;
} catch (Exception $e) {
echo "捕获到异常：" . $e->getMessage();
}
?>PHP常用调试方法
1. 使用调试函数输出信息
开发阶段可以用var_dump、print_r等函数输出变量信息，快速查看数据状态：
<?php
$user_info = [
'name' => '张三',
'age' => 25,
'email' => 'test@ipipp.com'
];
// 输出变量详细信息
var_dump($user_info);
// 输出易读的结构
echo "<pre>";
print_r($user_info);
echo "</pre>";
?>2. 使用debug_backtrace追踪调用栈
当错误出现在复杂的函数调用链中时，可以用debug_backtrace查看函数的调用路径，定位问题源头：
<?php
function func_a() {
func_b();
}
function func_b() {
func_c();
}
function func_c() {
// 获取调用栈信息
$trace = debug_backtrace();
echo "调用栈信息：<br/>";
foreach ($trace as $item) {
echo "文件：{$item['file']} | 行号：{$item['line']} | 函数：{$item['function']}<br/>";
}
}
func_a();
?>3. 日志调试
线上环境无法显示错误时，可以通过error_log将调试信息写入日志文件：
<?php
// 记录普通调试信息到日志
error_log("当前用户ID：1001，执行了订单查询操作", 3, '/tmp/debug.log');
// 也可以发送错误信息到指定邮箱，不过需要服务器配置邮件服务
// error_log("发生错误", 1, "admin@ipipp.com");
?>注意事项
线上环境一定要关闭错误显示，避免泄露服务器路径、代码逻辑等敏感信息，只保留错误日志记录即可：
<?php
// 线上环境配置
error_reporting(E_ALL);
ini_set('display_errors', 0);
ini_set('log_errors', 1);
ini_set('error_log', '/var/log/php_errors.log');
?>对于致命错误（比如E_ERROR级别的错误），set_error_handler无法捕获，这类错误会直接终止脚本，需要结合服务器日志或者PHP错误日志来排查。如果是PHP7及以上版本，还可以用set_exception_handler处理未捕获的异常，让程序更健壮。
PHP错误错误处理set_error_handlerdebug_backtraceerror_reporting修改时间：2026-06-02 23:06:42