CodeIgniter Ion Auth 用户认证系统完全指南

CodeIgniter Ion Auth 用户认证系统完全指南

CodeIgniter-Ion-Auth Simple and Lightweight Auth System for CodeIgniter 项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter-Ion-Auth

概述

Ion Auth 是一个专为 CodeIgniter 框架设计的轻量级用户认证系统，提供了完整的用户注册、登录、权限管理等功能。作为 CodeIgniter 生态中最受欢迎的认证库之一，它以简洁的 API 设计和灵活的配置选项著称。

核心特性

1. 完整的用户生命周期管理：注册、激活、登录、密码重置、账户更新等
2. 基于角色的权限系统：支持用户分组和权限检查
3. 安全机制：密码哈希、登录尝试限制、CSRF 防护等
4. 多语言支持：内置国际化支持
5. 高度可配置：几乎所有功能都可以通过配置文件调整

安装指南

系统要求

• PHP ≥ 7.2
• CodeIgniter 4 框架

安装步骤

1. 下载最新版本包

2. 将文件复制到应用目录对应位置：

   • 配置文件 → app/Config/IonAuth.php
   • 库文件 → app/Libraries/
   • 模型文件 → app/Models/

3. 执行数据库迁移：

php spark migrate:latest -n IonAuth

4. 导入初始数据：

php spark db:seed IonAuth\\Database\\Seeds\\IonAuthSeeder

默认管理员账号：

• 邮箱: admin@admin.com
• 密码: password

配置详解

数据库表配置

$tables = [
    'users'         => 'users',       // 用户表
    'groups'        => 'groups',      // 用户组表
    'users_groups'  => 'users_groups',// 用户-组关联表
    'login_attempts'=> 'login_attempts' // 登录尝试记录表
];

密码哈希选项

Ion Auth 支持两种现代哈希算法：

1. Bcrypt (PHP 5.3+)

   • bcryptDefaultCost: 默认计算强度(推荐10-12)
   • bcryptAdminCost: 管理员账户的计算强度(推荐12+)

2. Argon2 (PHP 7.2+，密码哈希竞赛冠军)

   • argon2DefaultParams: 默认参数
   • argon2AdminParams: 管理员账户参数

建议在生产环境前进行性能测试，确保哈希时间在100-500ms之间。

认证选项

$config = [
    'identity'          => 'email',   // 登录标识字段(email/username等)
    'minPasswordLength' => 8,        // 最小密码长度
    'emailActivation'   => false,    // 是否需要邮件激活
    'manualActivation'  => false,    // 是否需要管理员手动激活
    'rememberUsers'     => true      // 是否启用"记住我"功能
];

核心API使用

用户认证

// 用户登录
$auth->login($identity, $password, $remember);

// 检查登录状态
$auth->loggedIn();

// 用户登出
$auth->logout();

用户管理

// 创建用户
$auth->register($username, $password, $email, $additionalData);

// 更新用户
$auth->update($userId, $data);

// 删除用户
$auth->deleteUser($userId);

权限管理

// 检查用户组
$auth->inGroup($groupId, $userId);

// 添加用户到组
$auth->addToGroup($groupId, $userId);

// 从组中移除用户
$auth->removeFromGroup($groupId, $userId);

密码管理

// 密码重置请求
$auth->forgottenPassword($identity);

// 验证重置代码
$auth->forgottenPasswordCheck($code);

// 完成密码重置
$auth->resetPassword($identity, $newPassword);

最佳实践

1. 密码哈希：生产环境推荐使用Argon2算法，并适当调整参数
2. 登录限制：启用login_attempts表防止暴力攻击
3. 管理员账户：为管理员账户设置更高的哈希强度
4. 自定义验证：在控制器中添加额外的表单验证规则
5. 错误处理：合理处理errors()和messages()返回的信息

升级注意事项

从Ion Auth 2升级到4版本时需要注意：

1. 数据库结构变化
2. 配置选项更新
3. API方法调整

建议仔细阅读升级文档并进行充分测试。

总结

Ion Auth 为 CodeIgniter 应用提供了完整而安全的认证解决方案。通过合理的配置和使用，开发者可以快速构建出符合现代安全标准的用户系统。其模块化设计也使得它可以轻松集成到现有项目中，或根据特定需求进行扩展。

CodeIgniter-Ion-Auth Simple and Lightweight Auth System for CodeIgniter 项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter-Ion-Auth