Nginx - 自定義404頁面

Question

Nginx + PHP（在fastCGI上）對我很好。當我輸入一個不存在的PHP文件的路徑時，我只是得到一個「沒有指定輸入文件」，而不是獲得默認的404錯誤頁面（對於任何無效的.html文件）。

我如何定製這個404錯誤頁面？

Answer 1

您可以使用nginx config中的error_page屬性。

例如，如果你打算到404錯誤頁面設置爲/404.html，使用

error_page 404 /404.html; 

500錯誤頁面設置爲/500.html是一樣簡單：

error_page 500 /500.html; 

Answer 2

你可以設置nginx.conf中每個位置塊的自定義錯誤頁面，或整個網站的全局錯誤頁面。

重定向到一個簡單的404頁面未找到某個具體位置：

location /my_blog { 
    error_page 404 /blog_article_not_found.html; 
} 

站點寬404頁：

server { 
    listen 80; 
    error_page 404 /website_page_not_found.html; 
    ... 

您可以附加標準錯誤代碼在一起有一個單頁對於幾種類型的錯誤：

location /my_blog { 
    error_page 500 502 503 504 /server_error.html 
} 

要重定向到一個完全不同的服務器， g您必須在您的HTTP部分定義爲上游服務器名爲server2：

upstream server2 { 
    server 10.0.0.1:80; 
} 
server { 
    location /my_blog { 
     error_page 404 @try_server2; 
    } 
    location @try_server2 { 
     proxy_pass http://server2; 
    } 

的manual可以給你更多的細節，也可以搜索谷歌的條款nginx.conf和error_page在網絡上的真實例子。

Answer 3

「error_page」參數不夠。

最簡單的解決方法是

server{ 
    root /var/www/html; 
    location ~ \.php { 
     if (!-f $document_root/$fastcgi_script_name){ 
      return 404; 
     } 
     fastcgi_pass 127.0.0.1:9000; 
     include fastcgi_params.default; 
     fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name; 
    } 

順便說一句，如果你想Nginx的處理由PHP腳本返回404種狀態，你需要在添加

fastcgi_intercept_errors;

例如，

location ~ \.php { 
     #... 
     error_page 404 404.html; 
     fastcgi_intercept_errors on; 
    } 

Answer 4

不再推薦使用這些答案，因爲try_files工作速度比在這方面if。只需在你的PHP所在地塊添加try_files測試文件是否存在，否則返回一個404

location ~ \.php { 
    try_files $uri =404; 
    ... 
} 

Answer 5

要注意語法！大龜用他們互換，但：

error_page 404 = /404.html;

將與200狀態碼返回404.html頁面（因爲=未轉述，此頁）

error_page 404 /404.html;

威爾用（原始的）404錯誤代碼返回404.html頁面。

https://serverfault.com/questions/295789/nginx-return-correct-headers-with-custom-error-documents