php - 我将如何使用 PHP 异常来定义重定向？

Question

我一直被教导在编程中使用异常允许从抛出错误的对象中抽象出错误处理。看着 PHP manual , 似乎 PHP 有一个 Exception 类和一个 ErrorException 类，这表明并非所有异常都 是错误。因此，我想使用它们来帮助进行页面重定向。

我想要一个硬重定向，它只发送一个标题而不发送页面内容。触发此操作的最佳方法是什么？假设我有一个带有 redirect() 方法的 Controller 类。

该方法是否应该如下所示:

class Controller {
    public function redirect($path) {
        throw new Exception($path, 301);
    }
}

...

try {
    $controller->redirect('http://domain.tld/redirected');
} catch (Exception $e) {
    if ($e->getCode() == 301) {
        header('Location: ' . $e->getMessage());
    }
}

或者像这样:

class Controller {
    public function redirect($path) {
        header('Location: ' . $path);
        throw new Exception('The page is being redirected', 301);
    }
}

...

try {
    $controller->redirect('http://domain.tld/redirected');
} catch (Exception $e) {
    if ($e->getCode() == 301) {
        // Output nothing
    }
}

或者我应该像这样创建一个新类型的异常:

class RedirectException extends Exception {
    protected $url;

    public function __construct($url) {
        parent::__construct('The redirects are coming!', 301);
        $this->url = (string)$url;
    }

    public function getURL() {
        return $this->url;
    }
}

...

class Controller {
    public function redirect($path) {
        throw new RedirectException($path);
    }
}

...

try {
    $controller->redirect('http://domain.tld/redirected');
} catch (RedirectException $e) {
    header('Location: ' . $e->getURL());
}

虽然我觉得所有这些都行得通，但没有一个适合我。最后一个似乎是最接近的，因为它清楚地表明 URL 是必需的成员。然而，这样的异常(exception)只能服务于一个目的。构建一个处理所有 3XX、4XX 和 5XX 状态代码的 RequestException 是否更有意义？另外，消息呢？在这一点上，这会变成无关信息吗？

Answer 1

我自己也一直在玩这个。我将分享我对此事的看法。

理由

问:当您可以使用 header 和 die 语句轻松完成时，为什么有人会使用异​​常来重定向？

A:RFC2616 对使用状态码 301 进行重定向有这样的说法:

Unless the request method was HEAD, the entity of the response SHOULD contain a short hypertext note with a hyperlink to the new URI(s).

因此，您实际上需要一些代码才能正确实现重定向。最好只实现一次并使其易于重用。

问:但是你可以很容易地实现一个 redirect 方法，你不需要异常。

A:当你重定向时，你怎么知道用die杀死PHP脚本是“安全的”？也许堆栈下有一些代码在等待您返回，因此它可以运行一些清理操作。通过抛出异常，堆栈中的代码可以捕获此异常并进行清理。

比较

您的示例 #1 和 #3 实际上是相同的，区别在于您在 #1 中滥用了通用 Exception 类。异常的名称应该说明它的作用(RedirectException)，而不是属性(getCode() == 301)，尤其是因为没有地方定义代码在异常中应匹配 HTTP 状态代码。此外，在情况 #1 中想要捕获重定向的代码不能简单地执行 catch (RedirectException $re)，而是需要检查 getCode() 的结果。这是不必要的开销。

#2 和#3 之间最重要的区别是您对接收异常的类给予了多少控制权。在 #2 中，你几乎说“重定向即将到来，这正在发生”，catch block 没有可靠的方法来防止重定向发生。在 #3 中你说“我想重定向，除非你有更好的主意”，一个 catch block 将停止(“捕获”)重定向，并且直到异常被抛出到堆栈的下方才会发生。

选择哪个

这取决于您希望对堆栈中的代码进行多少控制。我个人认为堆栈中的代码应该能够取消重定向，这将使 #3 成为更好的选择。一个典型的用例是重定向到登录页面:想象一个方法将为当前用户执行一些操作，或者如果没有人登录则重定向到登录页面。可以从没有登录的页面调用此方法要求用户登录，但如果有，将提供额外的功能。只捕获异常比围绕该方法编写代码要干净得多，只是为了检查用户是否实际登录。

有些程序员可能会选择 #2，因为他们认为如果某些代码启动了重定向，则它期望此重定向会实际发生。允许拦截重定向并执行其他操作将使框架的可预测性降低。但是，我倾向于认为这就是异常的意义所在；除非某些代码有办法处理异常，否则会发生与异常相关的操作。此操作通常是错误消息的显示，但也可以是其他操作，例如重定向。

#3 的实现示例

class RedirectException extends Exception {
    const PERMANENT = 301;
    const FOUND = 302;
    const SEE_OTHER = 303;
    const PROXY = 305;
    const TEMPORARY = 307;

    private static $messages = array(
        301 => 'Moved Permanently',
        302 => 'Found',
        303 => 'See Other',
        305 => 'Use Proxy',
        307 => 'Temporary Redirect',
    );

    protected $url;

    public function __construct($url, $code = 301, $message =   NULL) {
        parent::__construct($message
            ? (string)$message
            : static::$messages[$code], (int)$code
            );
        if (strpos($url, '/') === 0) {
            $this->url = static::getBaseURL() . $this->url;
        }
        $this->url = (string)$url;
    }

    public function getURL() {
        return $this->url;
    }

    public function run() {
        header('Location: ' . $this->url, true, $this->getCode());
    }
}

结论

示例#1 和#3 几乎相同，但#3 的设计更好。 #2 和#3 都是很好的解决方案，具体取决于您的要求。示例 #2 将允许堆栈中的代码对重定向使用react，但无法阻止这种情况的发生。示例 #3 也将允许堆栈中的代码使用react，但它也会启用相同的代码来防止重定向发生。