https://github.com/dektrium/yii2-user
安装 ： composer require "dektrium/yii2-user:0.9.*@dev"
配置 ： 'modules' => [ 'user' => [ 'class' => 'dektrium\user\Module', ], ], 添加到config/web.php
注意 : 确保配置文件中没有别的 user 组件 如果 components 中有 user 的配置 注释掉
如果你需要自定义组件 可以：
'modules' => [
'user' => [
'class' => 'app\compoents\User',
'identityClass' => 'dektrium\user\Models\User',
],
],
生成数据库 : yii migrate/up --migrationPath=@vendor/dektrium/yii2-user/migrations
migration,
profile,
social_account,
token, user
配置信息：
enableFlashMessages 【默认为true】若为false 要自定义 提示信息 组件
enableRegistration 【true】是否开启注册功能
enableGeneratingPassword 【false】 不准用户自己输入密码 自动生成后通过邮件发送
enableConfirmation【true】 是否 要邮件验证
enableUnconfirmedLogin【false】邮件未验证 能不能登录
enablePasswordRecovery 【true】 用户能不能找回密码
emailChangeStrategy【STRATEGY_DEFAULT 】修改邮箱时 用那种策略:
\dektrium\user\Module::STRATEGY_DEFAULT 发送给新的邮箱 并点击确认链接
\dektrium\user\Module::STRATEGY_INSECURE 修改邮箱 不另行通知
\dektrium\user\Module::STRATEGY_SECURE 发送给新的 和旧的邮箱 都要点击确认链接
confirmWithin【86400（24小时）】令牌过期时间（秒）过期必须刷新页面
rememberFor【1209600（两周）】 记住用户的过期时间时间（秒）
recoverWithin【21600（6小时）】 在令牌过期前的规定时间内（秒） 要重新请求
admins 【[]】 能操作 用户管理页面 的用户们的用户名列表
adminPermission【null】 为用户指定RBAC权限的页面 最高权限 和 有此权限的用户可以操作
cost 【10】 生成hash值参数的位数 位数越高越能防御暴力攻击
urlPrefix 【user】 此模块的url前缀 如果设置为 auth ，auth/login, auth/admin, auth/register
urlRules 【[]】 URL 管理规则 ？？？
可用的动作：
- /user/registration/register 注册表单
- /user/registration/resend 发送表单
- /user/registration/confirm 确认 (需要id and token 参数)
- /user/security/login 登录表单
- /user/security/logout 退出登录 （仅支持post)
- /user/recovery/request ？？？
- /user/recovery/reset 重置密码 (需要id and token 参数)
- /user/settings/profile 个人资料设置？？
- /user/settings/account 账号设置 (email, username, password)
- /user/settings/networks 第三方账号登录
- /user/profile/show 显示用户头像？？ (需要id 参数)
- /user/admin/index 用户管理界面
- /user/admin/create 创建用户
- /user/admin/update 修改用户
- /user/admin/delete 删除用户
你可以重写 类 和 添加 行为和事件处理程序：
[
...
'user' => [
'class' => 'dektrium\user\Module',
'modelMap' => [
'User' => [
'class' => 'app\models\User',
'on user_create_init' => function () {
// do you magic
},
'as foo' => [
'class' => 'Foo',
],
],
],
],
...
]
重写默认view：
...
'components' => [
'view' => [
'theme' => [
'pathMap' => [
'@dektrium/user/views' => '@app/views/user'
],
],
],
],
...
重写控制器 和 使用事件：
namespace app\controllers\user; use dektrium\user\controllers\AdminController as BaseAdminController; class AdminController extends BaseAdminController
{
public function actionCreate()
{
// do your magic
}
}
------------------------------------------------------------------
...
'modules' => [
...
'user' => [
'class' => 'dektrium\user\Module',
'controllerMap' => [
'admin' => 'app\controllers\user\AdminController'
],
...
],
...
],
//重写控制器/方法
'user' => [
'class' => \dektrium\user\Module::className(),
'controllerMap' => [
'registration' => [
'class' => \dektrium\user\controllers\RegistrationController::className(),
'on ' . \dektrium\user\controllers\RegistrationController::EVENT_AFTER_REGISTER => function ($e) {
Yii::$app->response->redirect(array('/user/security/login'))->send();
Yii::$app->end();
}
],
],
],
// 注册之后 跳转到 登录页面 而不是仅仅提示信息
改变后台管理用户页面的 布局（layout）：
'modules' => [
...
'user' => [
'class' => 'dektrium\user\Module',
'controllerMap' => [
'admin' => [
'class' => 'app\controllers\user\AdminController',
'layout' => 'path-to-your-admin-layout',
],
],
...
],
...
],
使用第三方登录：
'components' => [
'authClientCollection' => [
'class' => yii\authclient\Collection::className(),
'clients' => [
'facebook' => [
'class' => 'dektrium\user\clients\Facebook',
'clientId' => 'CLIENT_ID',
'clientSecret' => 'CLIENT_SECRET',
],
'twitter' => [
'class' => 'dektrium\user\clients\Twitter',
'consumerKey' => 'CONSUMER_KEY',
'consumerSecret' => 'CONSUMER_SECRET',
],
'google' => [
'class' => 'dektrium\user\clients\Google',
'clientId' => 'CLIENT_ID',
'clientSecret' => 'CLIENT_SECRET',
],
],
],
],
facebook 获取的用户信息 补充到用户信息实例
use dektrium\user\controllers\SecurityController;
Event::on(SecurityController::class, SecurityController::EVENT_AFTER_AUTHENTICATE, function (AuthEvent $e) {
//如果用户不存在
if ($e->account->user === null) {
return;
}
// 不同的第三方平台提供的信息不 一样
switch ($e->client->getName()) {
case 'facebook':
$e->account->user->profile->updateAttributes([
'name' => $e->client->getUserAttributes()['name'],
]);
case 'vkontakte':
// some different logic
}
// 保存所有第三方用户属性到 model 下
// Yii::$app->identity->user->accounts['facebook']->decodedData
});
其他的功能 如：
自定义邮件发送类型 添加验证码 用户扩展字段 注册时填写更多信息等 下次分解