其他

PHP异常怎么自定义：PHP自定义异常类编写及错误类型扩展

悠悠楠杉

2026-01-06

0 评论

59 阅读

正在检测是否收录...

01/06

正文：

在PHP开发中，异常处理是保证程序健壮性的重要手段。虽然PHP内置了Exception类，但在实际业务中，我们往往需要更精细的错误分类和更灵活的异常处理逻辑。这时，自定义异常类就显得尤为重要。

一、为什么需要自定义异常类？

PHP默认的Exception类提供了基础的异常功能，比如错误消息、错误代码和堆栈跟踪。但在复杂业务场景中，我们可能需要：
1. 区分不同类型的错误（如数据库异常、API调用异常）；
2. 附加额外信息（如错误发生时的上下文数据）；
3. 统一错误处理逻辑（如日志记录、报警）。

通过继承Exception类，我们可以轻松实现这些需求。

二、如何编写自定义异常类？

自定义异常类只需继承Exception或其子类（如RuntimeException），并扩展需要的属性和方法。以下是一个典型的自定义异常类示例：

class DatabaseException extends Exception {
    private $query;

    public function __construct(string $message, string $query, int $code = 0) {
        parent::__construct($message, $code);
        $this->query = $query;
    }

    public function getQuery(): string {
        return $this->query;
    }

    public function __toString(): string {
        return __CLASS__ . ": [{$this->code}]: {$this->message} (Query: {$this->query})\n";
    }
}

代码解析：
1. 继承Exception基类，重写__construct以接收额外的$query参数；
2. 通过getQuery()方法暴露私有属性；
3. 重写__toString()定义异常的字符串表示形式。

三、如何使用自定义异常？

在业务代码中，通过throw抛出自定义异常，并通过try-catch捕获处理：

try {
    $query = "SELECT * FROM non_existent_table";
    if (!mysqli_query($connection, $query)) {
        throw new DatabaseException("Database query failed", $query, 1001);
    }
} catch (DatabaseException $e) {
    error_log("DB Error: " . $e->getMessage() . " | Query: " . $e->getQuery());
    // 返回友好错误信息
    echo "系统繁忙，请稍后再试";
} catch (Exception $e) {
    // 捕获其他类型的异常
    echo "未知错误：" . $e->getMessage();
}

优势：
- 精准捕获特定异常类型（如DatabaseException）；
- 可针对不同异常实现差异化处理（如记录日志、发送报警）；
- 避免直接暴露敏感信息（如SQL语句）。

四、扩展更多异常类型

除了数据库异常，我们还可以为不同模块定义专属异常类。例如：

class ApiException extends RuntimeException {
    private $url;
    private $response;

    public function __construct(string $url, array $response, string $message = "") {
        $this->url = $url;
        $this->response = $response;
        parent::__construct($message ?: "API request failed");
    }

    public function getContext(): array {
        return [
            'url' => $this->url,
            'response' => $this->response
        ];
    }
}

使用场景：
- API调用失败时抛出，附带请求URL和响应数据；
- 在catch块中通过getContext()获取完整上下文。