ubuntu

如何自定义Ubuntu PHP-FPM错误页面

小樊
39
2025-04-05 15:03:27
栏目: 编程语言

要自定义 Ubuntu 上的 PHP-FPM 错误页面,请按照以下步骤操作:

  1. 创建自定义错误页面文件

首先,创建一个自定义的错误页面文件。例如,创建一个名为 custom_error_page.php 的文件,并添加以下内容:

<?php
header("HTTP/1.0 404 Not Found");
echo "自定义 404 错误页面";

将此文件保存到您的 Web 服务器文档根目录中,例如 /var/www/html

  1. 修改 PHP-FPM 配置

接下来,您需要修改 PHP-FPM 配置以使用自定义错误页面。打开 /etc/php/版本号/fpm/pool.d/www.conf 文件,其中 版本号 是您安装的 PHP 版本。例如,如果您使用的是 PHP 7.4,则文件路径为 /etc/php/7.4/fpm/pool.d/www.conf

在文件中找到以下行:

catch_workers_output = yes

将其更改为:

catch_workers_output = no

这将允许 PHP-FPM 将错误输出发送到 Web 服务器。

  1. 修改 Web 服务器配置

现在,您需要修改 Web 服务器(例如 Nginx 或 Apache)的配置以使用自定义错误页面。

对于 Nginx,在 /etc/nginx/sites-available/您的站点配置文件 中添加以下内容:

error_page 404 /custom_error_page.php;
location = /custom_error_page.php {
    root /var/www/html;
}

对于 Apache,在 /etc/apache2/sites-available/您的站点配置文件 中添加以下内容:

ErrorDocument 404 /custom_error_page.php
  1. 重启 Web 服务器和 PHP-FPM

最后,重启 Web 服务器和 PHP-FPM 以使更改生效。

对于 Nginx:

sudo systemctl restart nginx
sudo systemctl restart php7.4-fpm

对于 Apache:

sudo systemctl restart apache2
sudo systemctl restart php7.4-fpm

现在,当用户访问不存在的页面时,他们将看到您的自定义错误页面。请根据需要更改错误代码和自定义页面内容。

0
看了该问题的人还看了