PHP自定义异常：使用类而非整数代码实现字符串标识符

在PHP开发中，异常处理是保证程序健壮性的重要环节。传统的异常使用方式往往依赖整数错误码来区分不同的异常类型，但这种方式存在可读性差、易冲突、扩展性弱等问题。本文将介绍如何通过自定义异常类，使用字符串标识符替代整数代码，让异常处理更清晰、更易维护。

传统异常处理的局限性

我们先看一段传统的异常处理示例，通过整数错误码区分异常类型：

<?php
try {
    $age = -5;
    if ($age < 0) {
        throw new Exception("年龄不能为负数", 1001); // 1001代表年龄参数错误
    }
    $email = "testippipp.com";
    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        throw new Exception("邮箱格式不正确", 1002); // 1002代表邮箱格式错误
    }
} catch (Exception $e) {
    $code = $e->getCode();
    if ($code == 1001) {
        echo "参数错误：" . $e->getMessage();
    } elseif ($code == 1002) {
        echo "格式错误：" . $e->getMessage();
    } else {
        echo "未知错误：" . $e->getMessage();
    }
}

这种方式的缺点很明显：整数错误码没有语义，开发者需要额外维护错误码和含义的映射表；不同模块的错误码容易冲突；新增异常类型时需要修改catch逻辑，扩展性差。

自定义异常类实现字符串标识符

我们可以通过继承PHP内置的Exception类，自定义异常类，在类中定义字符串类型的标识符，替代整数错误码。这样每个异常类型都有明确的语义，也方便后续扩展。

第一步：定义基础自定义异常类

首先定义一个基础异常类，包含字符串标识符属性，以及获取标识符的方法：

<?php
/**
 * 基础自定义异常类
 * 使用字符串标识符替代整数错误码
 */
class BaseException extends Exception
{
    // 字符串类型的异常标识符
    protected string $identifier;

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

    // 获取异常标识符
    public function getIdentifier(): string
    {
        return $this->identifier;
    }
}

第二步：定义具体业务异常类

针对不同的业务场景，我们可以继承基础异常类，定义具体的异常类，甚至可以在子类中固定标识符，避免重复定义：

<?php
// 年龄参数异常类
class AgeInvalidException extends BaseException
{
    // 固定标识符为age_invalid
    public function __construct(string $message, int $code = 0, Throwable $previous = null)
    {
        parent::__construct($message, "age_invalid", $code, $previous);
    }
}

// 邮箱格式异常类
class EmailInvalidException extends BaseException
{
    // 固定标识符为email_invalid
    public function __construct(string $message, int $code = 0, Throwable $previous = null)
    {
        parent::__construct($message, "email_invalid", $code, $previous);
    }
}

第三步：使用自定义异常类处理异常

在实际业务中使用自定义异常类，通过标识符区分异常类型，逻辑更清晰：

<?php
try {
    $age = -5;
    if ($age < 0) {
        throw new AgeInvalidException("年龄不能为负数");
    }
    $email = "testippipp.com";
    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        throw new EmailInvalidException("邮箱格式不正确");
    }
} catch (AgeInvalidException $e) {
    echo "年龄参数异常（标识符：{$e->getIdentifier()}）：" . $e->getMessage();
} catch (EmailInvalidException $e) {
    echo "邮箱格式异常（标识符：{$e->getIdentifier()}）：" . $e->getMessage();
} catch (BaseException $e) {
    echo "基础异常（标识符：{$e->getIdentifier()}）：" . $e->getMessage();
} catch (Exception $e) {
    echo "系统未知异常：" . $e->getMessage();
}

方案优势总结

• 语义清晰：字符串标识符如age_invalid、email_invalid可以直接看出异常类型，不需要额外维护错误码映射表。
• 避免冲突：不同模块可以定义自己的标识符前缀，比如用户模块用user_开头，订单模块用order_开头，减少冲突概率。
• 扩展性强：新增异常类型只需要新增对应的异常类，不需要修改已有的catch逻辑，符合开闭原则。
• 便于日志排查：日志中记录字符串标识符比整数错误码更直观，排查问题时可以快速定位异常类型。

注意事项

如果需要在异常中传递更多上下文信息，还可以在自定义异常类中添加额外的属性，比如错误相关的参数值、请求ID等，让异常信息更完整。另外，建议所有自定义异常都继承自同一个基础异常类，方便统一捕获和处理未预料的自定义异常。

PHP自定义异常字符串标识符Exception类错误处理代码可读性