CodeIgniter 4 应用中的会话认证与路由安全实践

// app/Filters/AuthGuard.php
<?php

namespace App\Filters;

use CodeIgniter\Filters\FilterInterface;
use CodeIgniter\HTTP\RequestInterface;
use CodeIgniter\HTTP\ResponseInterface;

class AuthGuard implements FilterInterface
{
    /**
     * 在控制器执行之前运行，用于检查用户是否登录。
     *
     * @param RequestInterface $request
     * @param array|null       $arguments
     * @return ResponseInterface|void
     */
    public function before(RequestInterface $request, $arguments = null)
    {
        // 检查会话中是否存在 'isLoggedIn' 标志
        if (!session()->get('isLoggedIn')) {
            // 如果未登录，重定向到登录页面
            return redirect()->to('/login');
        }
    }

    /**
     * 在控制器执行之后运行，通常用于日志记录或数据清理。
     * 在认证场景中，此方法通常留空。
     *
     * @param RequestInterface  $request
     * @param ResponseInterface $response
     * @param array|null        $arguments
     * @return void
     */
    public function after(RequestInterface $request, ResponseInterface $response, $arguments = null)
    {
        //
    }
}

// app/Controllers/LoginController.php (示例片段)
<?php

namespace App\Controllers;

use App\Controllers\BaseController;
use CodeIgniter\HTTP\RedirectResponse; // 引入 RedirectResponse

class LoginController extends BaseController
{
    public function authenticate(): RedirectResponse
    {
        // ... 验证用户凭据的逻辑 ...

        // 假设用户凭据验证成功，从数据库获取员工信息 $employee
        $employee = (object)[
            'id' => 1,
            'name' => 'John Doe',
            'email' => 'john.doe@example.com',
            'level' => 'admin',
        ]; // 示例数据

        $session_data = [
            'id' => $employee->id,
            'name' => $employee->name,
            'email' => $employee->email,
            'isLoggedIn' => true, // 设置登录标志
            'level' => $employee->level,
        ];

        // 将数据存储到会话中
        session()->set($session_data);

        // 重定向到仪表板
        return redirect()->to('/dashboard');
    }

    // ... 其他方法，如 logout ...
    public function logout(): RedirectResponse
    {
        session()->destroy(); // 销毁所有会话数据
        return redirect()->to('/login');
    }
}

// app/Config/Filters.php
<?php

namespace Config;

use CodeIgniter\Config\BaseConfig;
use CodeIgniter\Filters\CSRF;
use CodeIgniter\Filters\DebugToolbar;
use CodeIgniter\Filters\Honeypot;
use CodeIgniter\Filters\InvalidChars;
use CodeIgniter\Filters\SecureHeaders;

class Filters extends BaseConfig
{
    /**
     * 定义过滤器别名。
     * ...
     */
    public array $aliases = [
        'csrf'          => CSRF::class,
        'toolbar'       => DebugToolbar::class,
        'honeypot'      => Honeypot::class,
        'invalidchars'  => InvalidChars::class,
        'secureheaders' => SecureHeaders::class,
        'authGuard'     => \App\Filters\AuthGuard::class, // 为 AuthGuard 定义别名
    ];

    /**
     * 全局应用过滤器。
     * ...
     */
    public array $globals = [
        'before' => [
            // 'honeypot',
            // 'csrf',
            // 'invalidchars',
        ],
        'after' => [
            'toolbar',
            // 'honeypot',
            // 'secureheaders',
        ],
    ];

    /**
     * 特定路由组或HTTP方法的过滤器。
     * ...
     */
    public array $methods = [];

    /**
     * 过滤器映射到特定的路由。
     * ...
     */
    public array $filters = [
        'authGuard' => [
            'before' => [
                'list_customer', // 保护单个路由
                'dashboard/*',   // 保护 'dashboard' 路由下的所有子路由
                'admin/*',       // 保护 'admin' 路由组
            ],
            // 'after' => ['some_other_filter'], // 也可以定义 after 过滤器
        ],
    ];
}

// app/Controllers/Customer.php
<?php

namespace App\Controllers;

use App\Controllers\BaseController;
use App\Models\CustomerModel; // 引入模型

class Customer extends BaseController
{
    public function list_customer()
    {
       $customer_model = new CustomerModel();
       // 在用户已通过认证守卫的情况下，获取所有客户数据是常见的做法。
       // 重要的是，此路由本身受到 authGuard 保护。
       $data['all_customer'] = $customer_model->findAll(); 
       return view('list_customer', $data);
    }
}