CodeIgniter文件共享平台邮件发送不阻塞UI问题求助

嘿，我之前在CodeIgniter开发文件管理系统时也踩过邮件阻塞UI的坑，给你分享几个亲测有效的无阻塞解决方案，帮你搞定这个问题：

这个方案的核心是把邮件发送逻辑从请求流程中剥离，放到后台异步执行，完全不会影响前端跳转：

步骤1：创建任务队列表 #

先在数据库建一个email_tasks表，用来存待发送的邮件任务：

CREATE TABLE email_tasks (
    id INT AUTO_INCREMENT PRIMARY KEY,
    task_type VARCHAR(50) NOT NULL, -- 比如folder_created/admin_upload
    data TEXT NOT NULL, -- 存任务参数（JSON格式）
    status ENUM('pending', 'completed', 'failed') DEFAULT 'pending',
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    error_msg TEXT NULL
);

步骤2：编写CLI专用的邮件控制器 #

创建一个Email_notify.php控制器，专门处理后台邮件任务，注意要限制只能通过CLI访问：

<?php
class Email_notify extends CI_Controller {

    public function __construct() {
        parent::__construct();
        $this->load->library('email');
        $this->load->model('admin_model');
        $this->load->model('user_model');
        // 只允许CLI请求
        if (!$this->input->is_cli_request()) {
            show_404();
        }
    }

    // 批量处理队列中的任务
    public function process_tasks() {
        // 获取未处理的任务
        $tasks = $this->db->where('status', 'pending')->get('email_tasks')->result();

        foreach ($tasks as $task) {
            $task_data = json_decode($task->data, true);
            try {
                switch ($task->task_type) {
                    case 'folder_created':
                        $this->send_folder_notify($task_data['folder_id']);
                        break;
                    case 'admin_upload':
                        $this->send_admin_upload_notify($task_data['user_id'], $task_data['file_id']);
                        break;
                }
                // 标记任务为已完成
                $this->db->where('id', $task->id)->update('email_tasks', ['status' => 'completed']);
            } catch (Exception $e) {
                // 记录错误日志，标记任务失败
                log_message('error', "邮件任务失败ID:{$task->id}，原因：{$e->getMessage()}");
                $this->db->where('id', $task->id)->update('email_tasks', [
                    'status' => 'failed',
                    'error_msg' => $e->getMessage()
                ]);
            }
        }
    }

    // 发送文件夹创建通知给管理员
    private function send_folder_notify($folder_id) {
        $admins = $this->admin_model->get_all_admins();
        foreach ($admins as $admin) {
            $this->email->clear();
            $this->email->to($admin->email);
            $this->email->subject('新文件夹创建通知');
            $this->email->message("有用户创建了新文件夹，ID：{$folder_id}，可登录平台查看详情");
            $this->email->send();
        }
    }

    // 发送管理员上传通知给用户
    private function send_admin_upload_notify($user_id, $file_id) {
        $user = $this->user_model->get_user_by_id($user_id);
        $this->email->clear();
        $this->email->to($user->email);
        $this->email->subject('管理员为你上传了新文件');
        $this->email->message("管理员已为你上传文件，ID：{$file_id}，可登录平台查看");
        $this->email->send();
    }
}

步骤3：修改原控制器，写入任务队列 #

在你创建文件夹/管理员上传文件的控制器里，不再直接调用邮件方法，而是把任务写入数据库：

public function create_folder() {
    // 原有的文件夹创建逻辑...
    $folder_id = $this->folder_model->insert($folder_data);

    // 写入邮件任务队列
    $task = [
        'task_type' => 'folder_created',
        'data' => json_encode(['folder_id' => $folder_id]),
        'status' => 'pending'
    ];
    $this->db->insert('email_tasks', $task);

    // 立即返回JSON给前端重定向，完全不阻塞
    echo json_encode(['status' => 'success', 'folder_id' => $folder_id]);
}

步骤4：配置服务器定时任务 #

在服务器上添加cron定时任务，每分钟执行一次CLI命令处理队列：

* * * * * /usr/bin/php /path/to/your/project/index.php email_notify process_tasks >> /dev/null 2>&1

（注意替换成你服务器的PHP路径和项目绝对路径）

如果不想搞队列表，也可以直接用PHP的exec()函数把邮件任务丢到后台进程，适合小流量场景：

public function create_folder() {
    // 原有的文件夹创建逻辑...
    $folder_id = $this->folder_model->insert($folder_data);

    // 后台执行邮件发送命令，末尾的&表示丢到后台
    $php_path = '/usr/bin/php';
    $script_path = FCPATH . 'index.php';
    $command = "{$php_path} {$script_path} email_notify send_folder_notify {$folder_id} > /dev/null 2>&1 &";
    exec($command);

    // 立即返回JSON给前端
    echo json_encode(['status' => 'success', 'folder_id' => $folder_id]);
}

⚠️ 注意：要确保服务器没有禁用exec()函数，并且执行命令的用户有项目文件的访问权限。

如果你的平台用户量较大，建议用Redis或RabbitMQ做消息队列，配合CodeIgniter的第三方队列库（比如CodeIgniter Queue），能更高效地处理大量邮件任务，避免数据库队列的性能瓶颈。

几个通用注意事项 #

• 一定要开启CodeIgniter的日志功能，方便排查邮件发送失败的问题；
• 邮件发送逻辑要加异常捕获，避免单个任务失败导致整个队列卡住；
• 如果用CLI方式，要测试命令是否能正常执行，比如直接在服务器终端运行php index.php email_notify process_tasks看是否有报错。

内容的提问来源于stack exchange，提问作者Javier Toscano