README

Yii 2 用户 - 用户认证模块

新版本发布日期：2016年1月31日

本版本包含一些小更新和错误修复。最值得注意的是，我已经将 LoginForm.username 更改为 LoginForm.email，并在 app\models\Profile 中添加了一个时区字段（感谢 mnglkhn）

如果有任何问题，请告知我，我将尽快处理。

演示

演示

功能

快速设置 - 直接使用即可看到其功能
易于扩展
使用电子邮件和/或用户名注册
使用电子邮件和/或用户名登录
通过电子邮件（输入电子邮件 > 获取收件箱中的链接 > 点击链接登录/注册）登录/注册
电子邮件确认（+重发功能）
社交认证（Facebook、Twitter、Google、LinkedIn、Reddit、Vkontakte）
账户页面
- 更新电子邮件、用户名和密码
- 需要当前密码
个人资料页面
- 列出用户自定义字段，例如 full_name
密码恢复
通过 GridView 进行管理员 CRUD

安装

使用您喜欢的方安装 Yii 2
使用 composer 安装包 "amnah/yii2-user": "^5.0"
更新配置文件 config/web.php 和 config/db.php

// app/config/web.php
return [
    'components' => [
        // NOTE: in the yii2-advanced-app, the user component should be updated in
        // 'frontend/config/main.php' and/or 'backend/config/main.php' (OR you can add it
        // to 'common/config' if you remove it from frontend/backend)
        'user' => [
            'class' => 'amnah\yii2\user\components\User',
        ],
        'mailer' => [
            'class' => 'yii\swiftmailer\Mailer',
            'useFileTransport' => true,
            'messageConfig' => [
                'from' => ['[email protected]' => 'Admin'], // this is needed for sending emails
                'charset' => 'UTF-8',
            ]
        ],
    ],
    'modules' => [
        'user' => [
            'class' => 'amnah\yii2\user\Module',
            // set custom module properties here ...
        ],
    ],
];
// app/config/db.php
return [
    'class' => 'yii\db\Connection',
    // set up db info
];

运行迁移文件
- php yii migrate --migrationPath=@vendor/amnah/yii2-user/migrations
在浏览器中访问您的应用程序
- http://localhost/pathtoapp/web/user
- 注意：请访问 user/login 而不是 site/login
使用 neo/neo（请更改它！）作为管理员登录
根据需要设置模块属性
可选 - 更新主布局 app/views/layouts/main.php 中的导航链接

// app/views/layouts/main.php
<?php
'items' => [
    ['label' => 'Home', 'url' => ['/site/index']],
    ['label' => 'About', 'url' => ['/site/about']],
    ['label' => 'Contact', 'url' => ['/site/contact']],
    ['label' => 'User', 'url' => ['/user']],
    Yii::$app->user->isGuest ?
        ['label' => 'Login', 'url' => ['/user/login']] : // or ['/user/login-email']
        ['label' => 'Logout (' . Yii::$app->user->displayName . ')',
            'url' => ['/user/logout'],
            'linkOptions' => ['data-method' => 'post']],
],

开发说明

如何检查用户权限？

本包包含一个自定义权限系统。每个用户都有一个角色，该角色以数据库列的形式拥有权限。它应遵循以下格式：can_{permission name}。

例如，默认情况下，role 表有一个名为 can_admin 的列。要检查用户是否可以执行管理操作

if (!Yii::$app->user->can("admin")) {
    throw new HttpException(403, 'You are not allowed to perform this action.');
}
// --- or ----
$user = User::findOne(1);
if ($user->can("admin")) {
    // do something
};

根据需要添加更多数据库列以设置权限。如果您需要更强大的功能，请查看设置 [RBAC]（https://github.com/yiisoft/yii2/blob/master/docs/guide/security-authorization.md#role-based-access-control-rbac）。

注意：如果您为 RBAC 设置了 authManager 组件，那么 Yii::$app->user->can() 将使用该组件而不是此模块的自定义 role 表。

如何在表单中添加验证码？

请查看 dektrium 提供的出色的 3 步指南。（请注意，验证规则的场景将取决于您项目的需求。）

如何添加 i18n？

// app/config/web.php
return [
    'components' => [
        'i18n' => [
            'translations' => [
                'user' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'basePath' => '@app/messages', // example: @app/messages/fr/user.php
                ]
            ],
        ],
    ],
];

如何扩展此包？

您可以直接扩展类。根据您需要哪些类，设置适当的配置属性。

// app/config/web.php
'components' => [
    'user' => [
        'class' => 'app\components\MyUser',
        'identityClass' => 'app\models\MyUser',
    ],
],
'modules' => [
    'user' => [
        'class' => 'app\modules\MyModule',
        'controllerMap' => [
            'default' => 'app\controllers\MyDefaultController',
        ],
        'modelClasses'  => [
            'User' => 'app\models\MyUser', // note: don't forget component user::identityClass above
            'Profile' => 'app\models\MyProfile',
        ],
        'emailViewPath' => '@app/mail/user', // example: @app/mail/user/confirmEmail.php
    ],
],

对于视图文件，您可以使用theme组件。

// app/config/web.php
'components' => [
    'view' => [
        'theme' => [
            'pathMap' => [
                '@vendor/amnah/yii2-user/views' => '@app/views/user', // example: @app/views/user/default/login.php
            ],
        ],
    ],
],

我需要更多控制。我能否扩展整个组件？

您始终可以fork这个包并根据需要进行修改。

或者，如果您愿意，可以通过复制文件直接将包集成到您的应用程序中。这样做会使得更新更困难，但同时也保证了在运行composer update后您的应用程序不会崩溃。

为此，您可以使用辅助命令CopyController。

将模块添加到您的config/console.php中，以获得对命令的访问（注意：这是控制台配置）

// app/config/console.php
'modules' => [
    'user' => [
        'class' => 'amnah\yii2\user\Module',
    ],
],

使用php yii user/copy命令。对于基本应用程序，您可以调用默认命令而不带任何选项

php yii user/copy --from=@vendor/amnah/yii2-user --to=@app/modules/user --namespace=app\\modules\\user

更新配置以指向您的新包

// app/config/web.php + app/config/console.php
'modules' => [
    'user' => [
        'class' => 'app\modules\user\Module',
    ],
],

或者，您可以手动完成此操作。只需将文件复制粘贴到您希望的位置，并更改文件中的命名空间。将amnah\yii2\user替换为app\modules\user。

待办事项

测试
问题/请求？提交一个GitHub问题

amnah / yii2-user

维护者

详细信息