自定义404/403错误页面：Apache配置教程与最佳实践

721 字

4 分钟

自定义404/403错误页面：Apache配置教程与最佳实践

2022-05-13

Notes

Apache

Apache 错误页面 404, 403 配置教程#

在 PHP 网站开发中，当用户访问不存在的页面或无权限访问时，会出现 HTTP 404 (Not Found) 和 403 (Forbidden) 错误。为了提升用户体验，建议自定义错误页面，提供更有用的信息和引导。

本教程将介绍如何配置 Apache 错误页面，包括 404 和 403 错误。

配置方法：

错误页面的配置主要通过 Apache 的 httpd.conf 文件或 .htaccess 文件进行。 .htaccess 文件配置适用于虚拟主机用户，因为它们通常无法直接修改 Apache 的主配置文件。

1. 打开配置文件:

修改 httpd.conf 文件: 通常位于 /etc/httpd/conf/ 或 /etc/apache2/conf/，具体路径取决于你的 Linux 发行版。需要管理员权限才能修改。
创建或编辑 .htaccess 文件: 将 .htaccess 文件放置在你的网站根目录 (通常是 public_html, www, 或类似目录)。

2. 添加配置信息:

在配置文件中添加以下信息：

1
ErrorDocument 403 /403.html
2
ErrorDocument 404 /404.html

ErrorDocument: 指令用于定义当发生特定 HTTP 错误代码时显示哪个文件。
403: 表示 HTTP 错误代码 403 (Forbidden)。
404: 表示 HTTP 错误代码 404 (Not Found)。
/403.html 和 /404.html: 指定了当发生相应错误时，服务器将显示位于网站根目录下的 403.html 和 404.html 文件。你可以根据需要更改这些路径。

3. 保存配置文件并重启 Apache：

修改 httpd.conf: 保存文件后，需要重启 Apache 服务使更改生效。使用命令 sudo systemctl restart apache2 (Debian/Ubuntu) 或 sudo systemctl restart httpd (CentOS/RHEL) 重启服务器。
修改 .htaccess: .htaccess 文件通常会自动被 Apache 读取，无需重启 Apache。

4. 创建错误页面文件:

在网站根目录下创建 403.html 和 404.html 文件。这些文件将包含定制的错误信息。

例如 403.html:

1
<!DOCTYPE html>
2
<html>
3
<head>
4
    <title>403 Forbidden</title>
5
</head>
6
<body>
7
    <h1>403 Forbidden</h1>
8
    <p>您没有权限访问此资源。</p>
9
</body>
10
</html>

例如 404.html:

1
<!DOCTYPE html>
2
<html>
3
<head>
4
    <title>404 Not Found</title>
5
</head>
6
<body>
7
    <h1>404 Not Found</h1>
8
    <p>您请求的页面不存在。</p>
9
    <p>您可以尝试：</p>
10
    <ul>
11
        <li>检查您输入的网址是否正确</li>
12
        <li>返回 <a href="/">首页</a></li>
13
    </ul>
14
</body>
15
</html>

其他说明：

自动跳转到首页/其他网站: 虽然可以使用 ErrorDocument 指令将用户自动跳转到其他页面，但不建议这样做。这种做法会降低用户体验，让人感到困惑。
```
1
ErrorDocument 403 /index.php
2
ErrorDocument 404 http://www.google.com
```
确保文件权限: 请确保 403.html 和 404.html 文件具有正确的访问权限，以便 Apache 服务器可以读取它们。通常，权限设置为 644 即可。