php中如何抛出和捕获异常_php异常处理最佳实践

throw

try-catch

throw

Exception

try-catch

<?php

function divide(float $numerator, float $denominator): float
{
    if ($denominator === 0.0) {
        // 当除数为0时，我们认为这是一个异常情况，应该抛出异常
        throw new \InvalidArgumentException("除数不能为零。");
    }
    return $numerator / $denominator;
}

try {
    // 尝试执行可能抛出异常的代码
    echo divide(10, 2) . "\n";
    echo divide(5, 0) . "\n"; // 这一行会抛出异常
    echo "这行代码不会被执行。\n"; // 因为上一行抛出了异常
} catch (\InvalidArgumentException $e) {
    // 捕获特定类型的异常
    echo "捕获到一个无效参数异常: " . $e->getMessage() . "\n";
    // 我们可以选择记录日志，或者给用户一个友好的提示
} catch (\Exception $e) {
    // 捕获所有其他类型的异常（如果上面没有匹配到）
    echo "捕获到一个通用异常: " . $e->getMessage() . "\n";
} finally {
    // finally 块无论是否发生异常都会执行，常用于资源清理
    echo "无论如何，这部分代码都会执行。\n";
}

echo "程序继续执行。\n"; // 如果异常被捕获，程序可以继续执行
?>

try

catch

finally

try

Throwable

Exception

Error

TypeError

ParseError

Exception

Exception

Exception

Throwable

Exception

Error

<?php

// 示例：自定义一个用户相关的异常
class UserNotFoundException extends \Exception
{
    // 可以选择添加自定义的属性来存储更多信息
    protected $userId;

    public function __construct($message = "用户未找到", $code = 0, \Throwable $previous = null, $userId = null)
    {
        parent::__construct($message, $code, $previous);
        $this->userId = $userId;
    }

    public function getUserId(): ?int
    {
        return $this->userId;
    }

    // 也可以添加其他自定义方法
    public function getCustomErrorMessage(): string
    {
        return "尝试查找用户ID " . $this->userId . " 失败：" . $this->getMessage();
    }
}

function findUserById(int $id): string
{
    if ($id <= 0 || $id > 100) {
        // 假设只有ID在1到100之间才有用户
        throw new UserNotFoundException("指定的用户ID不存在。", 404, null, $id);
    }
    return "用户ID: {$id} 的信息。";
}

try {
    echo findUserById(50) . "\n";
    echo findUserById(101) . "\n"; // 这会抛出 UserNotFoundException
} catch (UserNotFoundException $e) {
    echo "捕获到用户未找到异常: " . $e->getCustomErrorMessage() . "\n";
    // 可以利用 $e->getUserId() 获取更多信息进行处理
} catch (\Exception $e) {
    echo "捕获到其他通用异常: " . $e->getMessage() . "\n";
}

?>

try-catch

error_log()

<?php
// 假设你已经安装了Monolog，并配置了一个Logger实例
// use Monolog\Logger;
// use Monolog\Handler\StreamHandler;
// $log = new Logger('my_app');
// $log->pushHandler(new StreamHandler(__DIR__ . '/app.log', Logger::WARNING));

function riskyOperation(): void
{
    // 模拟一个可能抛出异常的操作
    $result = 10 / 0; // 这会抛出 DivisionByZeroError (PHP 7+) 或警告 (PHP 5)
}

try {
    riskyOperation();
} catch (\Throwable $e) { // 捕获 Throwable 以处理 Exception 和 Error
    // 使用 Monolog 记录异常，这里简化为 error_log
    error_log("异常捕获: " . $e->getMessage() . 
              " 文件: " . $e->getFile() . 
              " 行: " . $e->getLine() . 
              " 堆栈: " . $e->getTraceAsString());
    // $log->error("An error occurred: " . $e->getMessage(), ['exception' => $e]);
    echo "一个运行时错误发生了，我们已经记录了它。\n";
}

?>

try-catch

set_exception_handler()

<?php

// 注册一个全局异常处理器
set_exception_handler(function (\Throwable $exception) {
    // 在这里处理所有未捕获的异常
    // 这通常是应用程序的最后一道防线

    // 1. 记录异常到日志
    error_log("全局未捕获异常: " . $exception->getMessage() . 
              " 文件: " . $exception->getFile() . 
              " 行: " . $exception->getLine() . 
              " 堆栈: " . $exception->getTraceAsString());
    // $log->critical("Uncaught exception!", ['exception' => $exception]);

    // 2. 向用户显示一个友好的错误页面或消息
    // 在生产环境中，不应该显示详细的错误信息给最终用户
    if (getenv('APP_ENV') === 'production') {
        echo "<h1>抱歉，服务器开小差了。</h1><p>我们已经记录了问题，会尽快修复。</p>";
    } else {
        echo "<h1>未捕获的异常！</h1>";
        echo "<p>消息: " . $exception->getMessage() . "</p>";
        echo "<p>文件: " . $exception->getFile() . " (行: " . $exception->getLine() . ")</p>";
        echo "<pre>" . $exception->getTraceAsString() . "</pre>";
    }

    // 3. 确保程序以非零状态码退出，表示有错误发生
    exit(1);
});

function anotherRiskyFunction(): void
{
    // 这个函数会抛出异常，但没有 try-catch 块来捕获它
    throw new \RuntimeException("这是一个未被局部捕获的运行时异常！");
}

// 调用这个函数，它的异常会被全局处理器捕获
anotherRiskyFunction();

echo "这行代码永远不会执行，因为全局处理器会调用 exit(1)。\n";

?>

try-catch