Nginx - 自定义404页面

Question

Nginx + PHP（在fastCGI上）对我很有用。当我输入一个不存在的PHP文件的路径时，我只是得到一个“没有指定输入文件。”而不是获取默认的404错误页面（来自任何无效的.html文件）。

如何自定义此404错误页面？

Answer 1

您可以在nginx 配置中使用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
}

要重定向到完全不同的服务器，假设您的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;
    }

手册可以为您提供更多详细信息，或者您可以搜索谷歌搜索网络上的真实例子的nginx.conf和error_page这两个术语。

Answer 3

小心语法！大乌龟互换使用它们，但是：

error_page 404 = /404.html;

将返回状态代码为200的404.html页面（因为=已将该内容转发到此页面）

error_page 404 /404.html;

将返回带有（原始）404错误代码的404.html页面。

https://serverfault.com/questions/295789/nginx -return-正确报头与 - 定制错误的文档

Answer 4

“error_page”参数进行重定向，将请求方法转换为“GET”，它不是自定义响应页面。

最简单的解决方案是

     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] [1] on;

E.g。

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

Answer 5

不再推荐这些答案，因为 try_files 在此上下文中比 if 更快。只需在php位置块中添加 try_files 即可测试文件是否存在，否则返回404。

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