PHP 错误处理：try-catch 与 set_error_handler()

在 PHP 开发中，错误处理是保障应用稳定性的关键环节。很多开发者对 try-catch 和 set_error_handler() 这两种机制的区别和使用场景感到困惑。本文将深入讲解这两种错误处理方式的原理、用法以及如何结合使用。

为什么需要系统化错误处理

PHP 中的错误和异常是两种不同的概念。错误（Error）是指运行时出现的问题，如文件不存在、内存不足等；异常（Exception）则是可以被捕获并处理的对象。默认情况下，PHP 会直接输出错误信息并终止脚本执行，这在生产环境中是极其危险的——用户会看到敏感的调试信息，攻击者可能利用这些信息发起攻击。

系统化的错误处理能够实现三个目标：屏蔽敏感信息、记录详细日志、提供友好的错误提示。没有完善的错误处理机制，应用既不安全，也不专业。

try-catch：异常处理的基石

异常的基本概念

异常是 PHP 5 引入的面向对象错误处理机制。当程序遇到异常情况时，会抛出一个异常对象，开发者可以捕获这个对象并做出相应处理。

try {
    // 可能抛出异常的代码
    $file = fopen('data.txt', 'r');
    if (!$file) {
        throw new Exception('无法打开文件');
    }

    $content = file_get_contents('data.txt');
    
} catch (Exception $e) {
    // 处理异常
    echo '发生错误：' . $e->getMessage();
}
```

### 多重捕获机制

PHP 支持多个 `catch` 块，可以针对不同类型的异常做出不同处理。这在处理不同业务逻辑时非常有用。

```php
try {
    $database->connect();
    $user = $database->query('SELECT * FROM users WHERE id = 1');

} catch (PDOException $e) {
    // 处理数据库异常
    log_error('数据库错误：' . $e->getMessage());
    echo '服务暂时不可用，请稍后再试';

} catch (Exception $e) {
    // 处理其他异常
    log_error('通用错误：' . $e->getMessage());
    echo '发生未知错误';
}

自定义异常类

对于复杂的业务逻辑，可以创建自定义异常类，以便更精确地分类和处理不同类型的错误。

class ValidationException extends Exception {}
class AuthenticationException extends Exception {}

function login($username, $password) {
    if (empty($username)) {
        throw new ValidationException('用户名不能为空');
    }
    
    $user = find_user_by_name($username);
    if (!$user || !password_verify($password, $user['password'])) {
        throw new AuthenticationException('用户名或密码错误');
    }

    return $user;
}

try {
    $current_user = login('', '123456');

} catch (ValidationException $e) {
    echo '输入错误：' . $e->getMessage();

} catch (AuthenticationException $e) {
    echo '认证失败：' . $e->getMessage();
}

set_error_handler：全局错误捕获

基本用法

set_error_handler() 允许你定义一个自定义函数，当 PHP 产生错误时自动调用这个函数。这种方式可以集中处理所有类型的运行时错误。

function error_handler($errno, $errstr, $errfile, $errline) {
    $error_types = [
        E_ERROR => 'Fatal Error',
        E_WARNING => 'Warning',
        E_PARSE => 'Parse Error',
        E_NOTICE => 'Notice',
        E_CORE_ERROR => 'Core Error',
        E_CORE_WARNING => 'Core Warning',
        E_COMPILE_ERROR => 'Compile Error',
        E_COMPILE_WARNING => 'Compile Warning',
        E_USER_ERROR => 'User Error',
        E_USER_WARNING => 'User Warning',
        E_USER_NOTICE => 'User Notice',
        E_STRICT => 'Strict Notice',
        E_RECOVERABLE_ERROR => 'Recoverable Error',
        E_DEPRECATED => 'Deprecated',
        E_USER_DEPRECATED => 'User Deprecated',
    ];
    
    $type = $error_types[$errno] ?? 'Unknown Error';
    $message = date('Y-m-d H:i:s') . " [$type] $errstr in $errfile on line $errline";
    
    // 记录日志
    error_log($message . PHP_EOL, 3, '/var/log/php/errors.log');

    // 在开发环境显示错误详情
    if (DEBUG_MODE) {
        echo $message;
    }
    
    // 返回 true 阻止 PHP 默认的错误处理
    return true;
}

// 注册错误处理器
set_error_handler('error_handler');
```

### 错误级别常量

PHP 定义了多个错误级别常量，理解这些常量对于精确控制错误处理至关重要。

| 常量 | 值 | 说明 |
|------|-----|------|
| `E_ERROR` | 1 | 致命错误，脚本终止执行 |
| `E_WARNING` | 2 | 警告错误，脚本继续执行 |
| `E_NOTICE` | 8 | 通知级别，如变量未初始化 |
| `E_PARSE` | 4 | 解析错误，语法问题 |
| `E_STRICT` | 2048 | 代码优化建议 |
| `E_DEPRECATED` | 8192 | 已废弃的功能警告 |
| `E_ALL` | 32767 | 所有错误和警告 |

可以在 `set_error_handler()` 中使用错误级别过滤，只处理特定类型的错误：

```php
// 只处理 E_WARNING、E_ERROR、E_PARSE 级别以上的错误
set_error_handler('error_handler', E_WARNING | E_ERROR | E_PARSE);
```

---

## 关键区别：异常与错误的本质差异

### 处理机制不同

`try-catch` 只能捕获通过 `throw` 抛出的异常对象，无法捕获传统的 PHP 错误。而 `set_error_handler()` 专门用于处理传统错误，但无法捕获 `throw` 抛出的异常。

```php
// try-catch 无法捕获以下错误
echo $undefined_variable;  // Notice 错误，try-catch 无效

// set_error_handler 无法捕获以下异常
throw new Exception('这是异常');  // 必须用 try-catch 捕获

错误与异常的转换

在 PHP 7 及以上版本，可以使用 throw 关键字将传统错误转换为异常，这使得错误处理更加统一。

// 将错误转换为异常
function custom_error_handler($errno, $errstr, $errfile, $errline) {
    throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
}

set_error_handler('custom_error_handler');

try {
    echo $undefined_variable;  // Notice 错误现在会抛出异常
    
} catch (ErrorException $e) {
    echo '捕获到错误（已转换为异常）：' . $e->getMessage();
}
```

---

## 最佳实践：双管齐下的错误处理策略

### 生产环境配置

在实际项目中，建议同时使用两种机制，形成完整的错误处理体系。

```php
<?php
// config.php
ini_set('display_errors', '0');  // 关闭错误显示
ini_set('log_errors', '1');       // 开启错误日志
error_reporting(E_ALL);           // 报告所有错误

// 定义错误处理器
set_error_handler(function($errno, $errstr, $errfile, $errline) {
    $log_message = sprintf(
        "[%s] PHP %s: %s in %s on line %d",
        date('Y-m-d H:i:s'),
        $errno,
        $errstr,
        $errfile,
        $errline
    );
    error_log($log_message);
    
    // 致命错误需要记录后立即终止
    if (in_array($errno, [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        error_log("Fatal error occurred, terminating script");
        http_response_code(500);
        echo '系统内部错误';
        exit(1);
    }

    return true;
});

// 定义未捕获异常处理器
set_exception_handler(function($exception) {
    error_log(sprintf(
        "[%s] Uncaught Exception: %s in %s on line %d",
        date('Y-m-d H:i:s'),
        $exception->getMessage(),
        $exception->getFile(),
        $exception->getLine()
    ));

    http_response_code(500);
    echo '系统内部错误';
});

// 注册关闭函数，确保致命错误也能记录
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        error_log(sprintf(
            "[%s] Shutdown Error: %s in %s on line %d",
            date('Y-m-d H:i:s'),
            $error['message'],
            $error['file'],
            $error['line']
        ));
    }
});

业务层的异常处理

在业务逻辑中，优先使用 try-catch 处理可预见的错误情况，保持代码清晰。

class UserService {
    public function createUser(array $data): User {
        // 参数验证
        $this->validateUserData($data);
        
        try {
            // 业务操作
            $this->database->beginTransaction();

            $user = new User();
            $user->name = $data['name'];
            $user->email = $data['email'];
            $user->created_at = date('Y-m-d H:i:s');

            $this->repository->save($user);
            $this->sendWelcomeEmail($user);

            $this->database->commit();
            return $user;

        } catch (PDOException $e) {
            $this->database->rollBack();
            throw new ServiceException('用户创建失败，请稍后重试', 0, $e);
        }
    }
    
    private function validateUserData(array $data): void {
        if (empty($data['name']) || strlen($data['name']) < 2) {
            throw new ValidationException('用户名长度至少2个字符');
        }

        if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
            throw new ValidationException('邮箱格式不正确');
        }
    }
}

常见陷阱与解决方案

忽略返回值

set_error_handler 的回调函数必须返回 true 或 false。返回 true 表示已处理错误，PHP 不会继续执行默认错误处理；返回 false 则 PHP 会继续执行默认行为。忘记返回值可能导致错误信息重复显示。

错误级别不匹配

某些错误无法被 set_error_handler 捕获，包括 E_ERROR、E_PARSE、E_CORE_ERROR 等。这些错误发生时，脚本会立即终止。对于这些致命错误，必须依赖 register_shutdown_function 进行处理。

异常继承问题

如果自定义异常类没有正确继承 Exception，catch 块将无法捕获。确保所有自定义异常都扩展自 Exception 类。

总结

PHP 的错误处理需要双管齐下：try-catch 负责捕获和处理业务异常，set_error_handler 负责统一管理运行时错误。在生产环境中，两者配合使用可以做到：错误不泄露、日志可追溯、用户无感知。记住一个原则：异常用于业务逻辑错误，错误处理器用于系统运行时问题。