Myth:Auth 使用教程

Myth:Auth 使用教程

myth-auth One-stop Auth package for CodeIgniter 4 项目地址: https://gitcode.com/gh_mirrors/my/myth-auth

1. 项目介绍

Myth:Auth 是一个为 CodeIgniter 4 框架设计的一站式认证包。它提供了包括用户注册、登录、登出以及忘记密码等基本认证服务。Myth:Auth 的主要特点包括：

• 密码认证：支持基于密码的认证，并提供“记住我”功能。
• RBAC（基于角色的访问控制）：遵循 NIST 标准，支持扁平 RBAC。
• 视图模板：提供登录、注册和忘记密码的视图模板，基于 Bootstrap 4。
• CLI 命令：支持通过 CLI 命令发布文件到主应用程序，便于自定义。
• 调试工具栏集成：与 CodeIgniter 4 的调试工具栏集成。
• 电子邮件验证：支持通过电子邮件进行账户验证。

2. 项目快速启动

2.1 安装

推荐使用 Composer 进行安装：

composer require myth/auth

2.2 配置

1. 配置 Email：编辑 app/Config/Email.php，确保设置了 fromName 和 fromEmail。

2. 配置验证规则：编辑 app/Config/Validation.php，添加以下规则集：

   public $ruleSets = [
       \CodeIgniter\Validation\Rules::class,
       \CodeIgniter\Validation\FormatRules::class,
       \CodeIgniter\Validation\FileRules::class,
       \CodeIgniter\Validation\CreditCardRules::class,
       \Myth\Auth\Authentication\Passwords\ValidationRules::class,
   ];
   

3. 运行数据库迁移：

   php spark migrate -all
   

2.3 使用

Myth:Auth 默认提供了基本的认证服务，包括用户注册、登录和忘记密码等功能。你可以通过访问相应的路由来使用这些功能。

3. 应用案例和最佳实践

3.1 自定义视图

Myth:Auth 提供了默认的视图模板，但你可以通过编辑 app/Config/Auth.php 中的 $views 变量来自定义视图：

public $views = [
    'login' => 'Myth\Auth\Views\login',
    'register' => 'Myth\Auth\Views\register',
    'forgot' => 'Myth\Auth\Views\forgot',
    'reset' => 'Myth\Auth\Views\reset',
    'emailForgot' => 'Myth\Auth\Views\emails\forgot',
];

3.2 使用 RBAC

Myth:Auth 支持基于角色的访问控制（RBAC）。你可以通过以下方式检查用户权限：

$authorize = service('authorization');
if ($authorize->inGroup('admin', user_id())) {
    // 用户是管理员
}

4. 典型生态项目

4.1 CodeIgniter 4

Myth:Auth 是为 CodeIgniter 4 框架设计的认证包，因此与 CodeIgniter 4 的生态系统紧密集成。CodeIgniter 4 是一个轻量级、快速且功能强大的 PHP 框架，适合构建各种 Web 应用程序。

4.2 Composer

Composer 是 PHP 的依赖管理工具，用于安装和管理项目依赖。Myth:Auth 推荐使用 Composer 进行安装，以确保依赖关系的正确管理。

4.3 Bootstrap 4

Myth:Auth 的默认视图模板基于 Bootstrap 4，这是一个流行的前端框架，提供了丰富的 UI 组件和样式，便于快速构建现代化的 Web 界面。

通过以上步骤，你可以快速上手并使用 Myth:Auth 进行用户认证管理。

myth-auth One-stop Auth package for CodeIgniter 4 项目地址: https://gitcode.com/gh_mirrors/my/myth-auth