關(guān)于thinkphp5手動拋出Http異常時(shí)自定義404頁面報(bào)錯(cuò)的問題

番茄西紅柿發(fā)布于2019-04-23 11:41 / 2197人閱讀

摘要：在使用手動拋出異常時(shí)，希望跳轉(zhuǎn)到自定義的錯(cuò)誤頁面，官方的文章中是這樣描述的。只能看源碼找問題了。而這個(gè)布局文件的路徑是一個(gè)相對路徑，這時(shí)如果你拋出異常的地方不是在的里，就找不到布局文件了。

在使用HttpException手動拋出異常時(shí)，希望跳轉(zhuǎn)到自定義的錯(cuò)誤頁面，官方的文章中是這樣描述的。

可以使用thinkexceptionHttpException類來拋出異常

// 拋出 HTTP 異常  
throw new thinkexceptionHttpException(404, 異常消息, null, [參數(shù)]);

一旦拋出了HttpException異常，可以支持定義多帶帶的異常頁面的模板地址，只需要在應(yīng)用配置文件中增加：

http_exception_template    =>  [  
    // 定義404錯(cuò)誤的重定向頁面地址  
    404 =>  APP_PATH.404.html,  
    // 還可以定義其它的HTTP status  
    401 =>  APP_PATH.401.html,  
]

然而如果你這些都做完了，關(guān)閉調(diào)試模式，你會發(fā)現(xiàn)還是跳轉(zhuǎn)到官方自定義的頁面上去了，并且你發(fā)現(xiàn)http狀態(tài)碼是500，這是代碼有問題啊，我拋出的是404啊。

然后打開log日志，你會發(fā)現(xiàn)果然報(bào)錯(cuò)了。

[ error ] [1]Uncaught thinkexceptionTemplateNotFoundException: template not exists:view/layout.html in /Applications/MAMP/htdocs/best.shiqidu.com/thinkphp/library/think/Template.php:1082  
Stack trace:

這。。。
可怎么辦。。。

只能看源碼找問題了。

你會發(fā)現(xiàn)這個(gè)方法被調(diào)用了兩次。

/**  
     * 解析模板文件名  
     * @access private  
     * @param  string $template 文件名  
     * @return string|false  
     */  
    private function parseTemplateFile($template)  
    {...}

第一次時(shí)$template模板文件時(shí)能找到的。但是第二次也是一個(gè)相對路徑view/layout，所以報(bào)錯(cuò)了，繼續(xù)順藤摸瓜，發(fā)現(xiàn)這個(gè)函數(shù)。

/**  
     * 編譯模板文件內(nèi)容  
     * @access private  
     * @param string    $content 模板內(nèi)容  
     * @param string    $cacheFile 緩存文件名  
     * @return void  
     */  
    private function compiler(&$content, $cacheFile)  
    {  
        // 判斷是否啟用布局  
        if ($this->config[layout_on]) {  
            if (false !== strpos($content, {__NOLAYOUT__})) {  
                // 可以多帶帶定義不使用布局  
                $content = str_replace({__NOLAYOUT__}, , $content);  
            } else {  
                // 讀取布局模板  
                $layoutFile = $this->parseTemplateFile($this->config[layout_name]);  
                if ($layoutFile) {  
                    // 替換布局的主體內(nèi)容  
                    $content = str_replace($this->config[layout_item], $content, file_get_contents($layoutFile));  
                }  
            }  
        } else {  
            $content = str_replace({__NOLAYOUT__}, , $content);  
        }  
...

關(guān)鍵就是這里了，如果你沒有{__NOLAYOUT__}這個(gè)表示的話，它在渲染自定義404頁面時(shí)會去加載布局文件（如果你在配置文件里開啟了布局，如果沒開啟layout=true，也不會報(bào)這個(gè)錯(cuò)）。
而這個(gè)布局文件的路徑是一個(gè)相對路徑，這時(shí)如果你拋出異常的地方不是在application的controller里，就找不到布局文件了。所以就報(bào)錯(cuò)了。

怎么解決呢？其實(shí)也很簡單。給自定義的404頁面加上{__NOLAYOUT__}就行了。

這一點(diǎn)官方文檔沒有說明，還在坑里的同學(xué)可以參考改下。