PHP自定义异常：使用类而非字符串代码进行类型区分的最佳实践

<?php

// 可选：定义一个应用层面的基础异常类，便于统一捕获和处理
// class MyApplicationException extends \Exception {}

// 定义特定业务异常：用户未找到
class UserNotFoundException extends \Exception {
    public function __construct(string $message = "用户未找到", int $code = 0, ?\Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
    }
}

// 示例：其他业务异常
class InvalidInputException extends \Exception {
    public function __construct(string $message = "输入无效", int $code = 0, ?\Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
    }
}

<?php

// 假设有一个User类
class User {
    private int $id;

    public function __construct(int $id) {
        $this->id = $id;
    }

    public function delete_user(): void {
        // 模拟用户不存在的场景
        if ($this->id === 100) { // 假设ID 100 代表不存在的用户
            throw new UserNotFoundException("ID为 {$this->id} 的用户不存在");
        }
        // 实际删除用户的逻辑
        echo "用户 {$this->id} 已删除。\n";
    }
}

// 示例调用
try {
    $user = new User(100);
    $user->delete_user();
} catch (UserNotFoundException $e) {
    echo "捕获到错误: " . $e->getMessage() . "\n";
} catch (\Exception $e) {
    echo "捕获到未知错误: " . $e->getMessage() . "\n";
}

<?php

use PHPUnit\Framework\TestCase;

class UserTest extends TestCase {
    public function testDeleteNonExistingUserThrowsUserNotFoundException(): void {
        // 期望抛出 UserNotFoundException 类型的异常
        $this->expectException(UserNotFoundException::class);
        // 如果需要断言异常消息，可以使用 expectExceptionMessage()
        $this->expectExceptionMessage("ID为 100 的用户不存在");
        // 如果需要断言异常代码（整数），可以使用 expectExceptionCode()
        // $this->expectExceptionCode(0); // 因为我们没有设置特定的整数代码，默认为0

        // 触发异常的代码
        $User = new User(100); // 100 是一个不存在用户的ID
        $User->delete_user(); // 此方法会抛出 UserNotFoundException
    }

    public function testDeleteExistingUserSuccessfully(): void {
        // 期望不抛出任何异常
        $this->expectNotToPerformAssertions(); // 或者直接不设置 expectException

        $User = new User(1); // 假设ID 1 是一个存在的用户
        $User->delete_user();
        // 可以在这里添加其他断言，例如检查数据库状态等
        $this->assertTrue(true); // 仅为示例，表示测试通过
    }
}

<?php

class ValidationException extends \Exception {
    protected string $validationErrorCode;

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

    public function getValidationErrorCode(): string {
        return $this->validationErrorCode;
    }
}

// 抛出异常
// throw new ValidationException("邮箱格式不正确", "INVALID_EMAIL_FORMAT");

// 捕获和检查
// try { /* ... */ } catch (ValidationException $e) {
//     if ($e->getValidationErrorCode() === "INVALID_EMAIL_FORMAT") { /* ... */ }
// }