PHP CodeIgniter 4框架419页面过期：如何重定向至登录页？

一、处理CSRF令牌过期导致的419错误 #

CodeIgniter 4默认会在CSRF验证失败时返回419页面，我们可以通过自定义过滤器替换默认行为：

1. 创建自定义CSRF过滤器
   在app/Filters目录下新建CustomCsrf.php文件，代码如下：

<?php

namespace App\Filters;

use CodeIgniter\Filters\CSRF as BaseCSRF;
use CodeIgniter\HTTP\RequestInterface;

class CustomCsrf extends BaseCSRF
{
    public function before(RequestInterface $request, $arguments = null)
    {
        try {
            parent::before($request, $arguments);
        } catch (\CodeIgniter\Exceptions\SecurityException $e) {
            // 重定向到登录页，根据实际路由调整地址
            return redirect()->to('/login')->with('error', '会话已过期，请重新登录');
        }
    }
}

2. 替换默认CSRF过滤器配置
   打开app/Config/Filters.php，修改$aliases数组中csrf的指向：

public $aliases = [
    // 保留其他原有别名
    'csrf' => \App\Filters\CustomCsrf::class,
];

二、处理会话超时导致的419错误 #

用户会话过期后访问需要登录权限的页面，也会触发类似问题，可通过基础控制器统一校验：

1. 创建基础控制器
   在app/Controllers目录下新建BaseController.php：

<?php

namespace App\Controllers;

use CodeIgniter\Controller;

class BaseController extends Controller
{
    public function initController(\CodeIgniter\HTTP\RequestInterface $request, \CodeIgniter\HTTP\ResponseInterface $response, \Psr\Log\LoggerInterface $logger)
    {
        parent::initController($request, $response, $logger);

        $session = session();
        // 根据你的登录逻辑，判断用户是否处于登录状态
        if (!$session->has('user_id')) {
            // 若未登录且当前不是登录页，重定向到登录页
            if ($this->request->getUri()->getPath() !== '/login') {
                return redirect()->to('/login')->with('error', '会话已过期，请重新登录');
            }
        }
    }
}

2. 让需要登录权限的控制器继承基础控制器
   例如后台管理控制器：

<?php

namespace App\Controllers;

class Admin extends BaseController
{
    // 控制器业务方法
}

三、全局处理419状态码（可选） #

如果希望所有419错误都统一重定向，可修改异常配置：
打开app/Config/Exceptions.php，在$redirect数组中添加419状态码的规则：

public $redirect = [
    // 保留其他原有规则
    419 => '/login',
];

注意事项 #

• 确保登录页不在CSRF验证的拦截范围内，可在app/Config/Filters.php的$filters数组中，给csrf添加例外路由：

public $filters = [
    'csrf' => [
        'except' => ['login/*'],
    ],
];

• 替换示例中的/login为你项目实际的登录页路由
• 会话登录状态的判断条件需与你项目的登录逻辑保持一致

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