如何将CodeIgniter错误提示替换为自定义标准文本？

嘿，这个需求完全可以实现！在CodeIgniter里控制错误显示是非常关键的安全操作——既能避免泄露服务器路径、代码细节这些敏感信息，又能给用户友好的反馈。下面分步骤来帮你配置：

1. 先搞定核心环境配置 #

首先打开对应版本的配置文件，调整几个关键参数：

CodeIgniter 3.x 配置 #

修改application/config/config.php：

// 把环境设置为生产环境，这会自动关闭详细错误显示
define('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'production');

// 开启日志记录（强烈推荐），这样你能在后台查看具体错误，用户看不到
$config['log_threshold'] = 1; // 1=仅记录错误，2=错误+警告，按需调整

// 强制关闭页面输出错误详情
$config['display_errors'] = FALSE;

CodeIgniter 4.x 配置 #

修改app/Config/App.php：

public $environment = ENVIRONMENT::PRODUCTION;
public $displayErrors = false;
public $logThreshold = 1;

2. 创建自定义错误页面 #

接下来做用户看到的友好提示页面：

第一步：创建错误控制器（以CI3为例） #

在application/controllers/下新建Errors.php：

<?php
class Errors extends CI_Controller {
    public function __construct() {
        parent::__construct();
        // 可选：禁止用户直接访问这个控制器
        if (!is_cli()) {
            // 这里可以加简单的权限判断逻辑
        }
    }

    public function server_error() {
        // 设置正确的HTTP状态码（500表示服务器内部错误）
        $this->output->set_status_header(500);
        // 加载自定义错误视图
        $this->load->view('errors/custom_server_error');
    }
}

第二步：创建错误视图 #

在application/views/errors/下新建custom_server_error.php：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>服务器出错啦</title>
    <style>
        body { text-align: center; padding: 50px; font-family: Arial, sans-serif; }
        h1 { font-size: 2em; color: #dc3545; }
        p { font-size: 1.1em; color: #666; }
    </style>
</head>
<body>
    <h1>发现错误，已通知网站管理员</h1>
    <p>我们正在紧急处理这个问题，请稍后再访问哦~</p>
</body>
</html>

3. 配置错误路由和异常处理 #

让系统在出错时自动跳转到你的自定义页面：

CodeIgniter 3.x 路由配置 #

打开application/config/routes.php，添加：

// 把系统默认的500错误路由到我们的控制器
$route['error_500'] = 'Errors/server_error';

然后重写异常处理类，让所有未捕获的异常都跳转到自定义页面：
在application/core/下新建MY_Exceptions.php：

<?php
class MY_Exceptions extends CI_Exceptions {
    public function show_error($heading, $message, $template = 'error_general', $status_code = 500) {
        // 直接跳转到自定义错误页面
        redirect('error_500');
    }
}

CodeIgniter 4.x 异常配置 #

在app/Config/Exceptions.php里修改错误视图映射：

public $errorViews = [
    500 => 'errors/custom_server_error',
    // 还可以添加404、403等其他错误的自定义视图
];

或者用事件监听异常，在app/Config/Events.php里注册：

Events::on('exception', static function(\Throwable $e) {
    if (ENVIRONMENT === ENVIRONMENT::PRODUCTION) {
        return redirect()->to('/error/500')->withStatus(500);
    }
});

几个重要提醒 #

• 务必开启日志：虽然用户看不到错误，但你需要通过日志排查问题，日志文件在application/logs/（CI4是writable/logs/）
• 测试时切换环境：开发阶段可以把ENVIRONMENT设为development，方便看到详细错误调试
• 覆盖所有错误场景：除了500错误，还可以给404、403等错误也设置自定义页面，提升用户体验

内容的提问来源于stack exchange，提问作者Scott O'connor