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

// 期望的抛出方式
throw new CustomException("user_not_found", "User not found");

// 期望的测试方式
$this->expectExceptionCode("user_not_found");

<?php

namespace App\Exceptions;

use Exception;
use Throwable;

/**
 * 应用程序的基础异常类，可存储一个内部字符串标识符。
 */
class AppException extends Exception
{
    protected string $internalIdentifier;

    /**
     * 构造函数。
     *
     * @param string $internalIdentifier 一个唯一的字符串标识符，例如 'user_not_found'。
     * @param string $message 异常消息。
     * @param int $code 异常的数值代码（可选，默认为0）。
     * @param Throwable|null $previous 前一个抛出的异常（可选）。
     */
    public function __construct(string $internalIdentifier, string $message = "", int $code = 0, ?Throwable $previous = null)
    {
        parent::__construct($message, $code, $previous);
        $this->internalIdentifier = $internalIdentifier;
    }

    /**
     * 获取此异常的内部字符串标识符。
     *
     * @return string
     */
    public function getInternalIdentifier(): string
    {
        return $this->internalIdentifier;
    }
}

<?php

namespace App\Exceptions;

use Throwable;

/**
 * 当用户未找到时抛出的异常。
 */
class UserNotFoundException extends AppException
{
    /**
     * 构造函数。
     *
     * @param string $message 异常消息（可选，默认为“User not found”）。
     * @param int $code 异常的数值代码（可选）。
     * @param Throwable|null $previous 前一个抛出的异常（可选）。
     */
    public function __construct(string $message = "User not found", int $code = 0, ?Throwable $previous = null)
    {
        // 调用父类构造函数，并传入此异常的字符串标识符
        parent::__construct('user_not_found', $message, $code, $previous);
    }
}

// 示例：其他可能的异常类
// class InvalidArgumentException extends AppException {
//     public function __construct(string $message = "Invalid argument provided", int $code = 0, ?Throwable $previous = null) {
//         parent::__construct('invalid_argument', $message, $code, $previous);
//     }
// }

<?php

namespace App\Services;

use App\Exceptions\UserNotFoundException;

class UserService
{
    public function getUserById(int $id): object
    {
        // 假设这是一个模拟的用户查找过程
        if ($id === 100) { // 假设ID 100代表一个不存在的用户
            throw new UserNotFoundException("User with ID {$id} was not found.");
        }
        // ... 正常逻辑返回用户对象
        return (object)['id' => $id, 'name' => 'Existing User'];
    }

    public function deleteUser(int $id): void
    {
        if ($id === 100) {
            throw new UserNotFoundException("Cannot delete: User with ID {$id} does not exist.");
        }
        // ... 删除用户逻辑
    }
}

<?php

namespace Tests\Unit;

use PHPUnit\Framework\TestCase;
use App\Services\UserService;
use App\Exceptions\UserNotFoundException;

class UserServiceTest extends TestCase
{
    /**
     * 测试当用户不存在时是否抛出 UserNotFoundException。
     */
    public function testUserNotFoundThrowsException(): void
    {
        // 期望抛出 UserNotFoundException 类
        $this->expectException(UserNotFoundException::class);

        // 期望异常消息中包含特定文本（可选）
        $this->expectExceptionMessage("User with ID 100 was not found.");

        $userService = new UserService();
        $userService->getUserById(100); // 这个方法会抛出 UserNotFoundException
    }

    /**
     * 测试删除不存在用户时是否抛出 UserNotFoundException。
     */
    public function testDeleteNonExistingUserThrowsException(): void
    {
        $this->expectException(UserNotFoundException::class);
        $this->expectExceptionMessage("Cannot delete: User with ID 100 does not exist.");

        $userService = new UserService();
        $userService->deleteUser(100);
    }

    /**
     * 示例：如何获取内部字符串标识符进行额外断言（如果需要）。
     */
    public function testUserNotFoundExceptionHasCorrectIdentifier(): void
    {
        try {
            $userService = new UserService();
            $userService->getUserById(100);
            $this->fail("Expected UserNotFoundException was not thrown.");
        } catch (UserNotFoundException $e) {
            // 捕获到特定异常后，可以检查其内部标识符
            $this->assertEquals('user_not_found', $e->getInternalIdentifier());
            $this->assertEquals("User with ID 100 was not found.", $e->getMessage());
        }
    }
}