本文探讨了在PHP中为自定义异常提供字符串标识的最佳实践。鉴于PHP原生异常代码仅支持整数，文章详细介绍了如何通过定义继承自`\Exception`的自定义异常类来解决这一限制。核心方法是为每种错误情况创建独立的异常类，并结合PHPUnit的`expectException(ClassName::class)`方法进行类型安全的测试，从而实现清晰、可维护且易于测试的异常处理机制。
1. PHP异常代码的限制与字符串标识的需求
在PHP中，原生的\Exception类及其子类的code属性被设计为存储一个整数值。然而，在实际开发中，开发者常常希望使用更具描述性的字符串（例如"user_not_found"、"invalid_input"）作为异常的标识，以便于理解错误类型、进行条件处理或编写更具可读性的测试。
例如，理想情况下，我们可能希望像这样抛出和测试一个自定义异常：
// 期望的抛出方式
throw new CustomException("user_not_found", "用户未找到");
// 期望的测试方式
$this->expectExceptionCode("user_not_found");然而，由于expectExceptionCode()方法期望的是一个整数，直接传入字符串会导致不符合预期。一些开发者可能会尝试将字符串标识存储在异常的上下文数组中，例如：
立即学习“PHP免费学习笔记（深入）”；
throw new CustomException("用户未找到", ["debug" => "user_not_found"]);然后在测试中通过捕获异常并断言上下文内容：
try {
// ... 触发异常的代码 ...
} catch (\Throwable $e) {
$this->assertEquals("user_not_found", $e->getContext()["debug"]);
}这种方法虽然可行，但增加了测试代码的复杂性，且不够直观。更优雅和类型安全的方法是利用PHP的面向对象特性，为每种特定的错误情况创建独立的异常类。
2. 推荐方案：通过自定义异常类实现类型安全标识
为了克服PHP原生异常代码的整数限制，并实现字符串标识的便利性，最佳实践是为每一种特定的错误类型定义一个独立的自定义异常类。PHPUnit提供了expectException(ClassName::class)方法，允许我们直接断言抛出的异常类型，这比依赖整数代码或上下文数组更加强大和类型安全。
2.1 步骤一：创建基础自定义异常类
首先，我们可以定义一个基础异常类，它继承自PHP的\Exception。这个基础类可以用于封装一些通用的异常行为或属性，例如，如果仍希望在异常实例中携带一个字符串标识符（例如用于日志记录或内部处理），可以在这里进行定义。
stringCode = $stringCode;
}
/**
* 获取自定义字符串标识
* @return string
*/
public function getStringCode(): string
{
return $this->stringCode;
}
}代码解析：
- MyBaseException 继承自 \Exception，确保它是一个标准的PHP异常。
- 新增了 $stringCode 属性用于存储我们所需的字符串标识。
- 构造函数接受 $stringCode 作为第一个参数，并将其存储起来。同时，它也接受标准的 $message、$numericCode 和 $previous 参数，并正确地传递给父类\Exception的构造函数。
- 提供了 getStringCode() 方法，允许在捕获异常后访问这个字符串标识。
2.2 步骤二：实现具体的业务异常类
接下来，为每种特定的业务错误场景创建具体的异常类。这些类将继承自MyBaseException。
代码解析：
- UserNotFoundException 继承自 MyBaseException。
- 在其构造函数中，它直接调用 parent::__construct() 并传入了特定的字符串标识 'user_not_found'，以及默认的错误消息。这样，每个具体的异常类就拥有了其独特的字符串标识。
2.3 步骤三：抛出自定义异常
在业务逻辑中，当特定错误发生时，抛出相应的自定义异常：
delete_user(100);
} catch (UserNotFoundException $e) {
echo "捕获到用户未找到异常: " . $e->getMessage() . " (Code: " . $e->getStringCode() . ")\n";
} catch (MyBaseException $e) {
echo "捕获到基础自定义异常: " . $e->getMessage() . " (Code: " . $e->getStringCode() . ")\n";
} catch (\Exception $e) {
echo "捕获到通用异常: " . $e->getMessage() . "\n";
}
