Skip to content
Yii 2 User Authentication & Role Based Access Control (RBAC) Module
PHP
Latest commit 7679b7c Jul 2, 2015 @robregonm Merge pull request #47 from belozorov63/master
Add russian language
Failed to load latest commit information.
components
controllers [FIX] Fix bug when updating password in profile page May 22, 2015
messages Add russian language Jul 1, 2015
migrations
models
views implement signup with email only Mar 2, 2015
LICENSE Initial commit Nov 24, 2013
Module.php
README.md
composer.json

README.md

Auth Module

Auth Module is a flexible user registration, authentication & RBAC module for Yii2. It provides user authentication, registration and RBAC support to your Yii2 site.

Installation

The preferred way to install this extension is through composer.

Either run

$ php composer.phar require robregonm/yii2-auth "*"

or add

"robregonm/yii2-auth": "*"

to the require section of your composer.json file.

Usage

Once the extension is installed, modify your application configuration to include:

return [
    'modules' => [
        ...
            'auth' => [
                'class' => 'auth\Module',
                'layout' => '//homepage', // Layout when not logged in yet
                'layoutLogged' => '//main', // Layout for logged in users
                'attemptsBeforeCaptcha' => 3, // Optional
                'supportEmail' => 'support@mydomain.com', // Email for notifications
                'passwordResetTokenExpire' => 3600, // Seconds for token expiration
                'superAdmins' => ['admin'], // SuperAdmin users
                'signupWithEmailOnly' => false, // false = signup with username + email, true = only email signup
                'tableMap' => [ // Optional, but if defined, all must be declared
                    'User' => 'user',
                    'UserStatus' => 'user_status',
                    'ProfileFieldValue' => 'profile_field_value',
                    'ProfileField' => 'profile_field',
                    'ProfileFieldType' => 'profile_field_type',
                ],
            ],
        ...
    ],
    ...
    'components' => [
        ...
        'authManager' => [
            'class' => '\yii\rbac\DbManager',
            'ruleTable' => 'AuthRule', // Optional
            'itemTable' => 'AuthItem',  // Optional
            'itemChildTable' => 'AuthItemChild',  // Optional
            'assignmentTable' => 'AuthAssignment',  // Optional
        ],
        'user' => [
            'class' => 'auth\components\User',
            'identityClass' => 'auth\models\User', // or replace to your custom identityClass
            'enableAutoLogin' => true,
        ],
        ...
    ]
];

And run migrations:

$ php yii migrate/up --migrationPath=@auth/migrations

License

Auth module is released under the BSD-3 License. See the bundled LICENSE.md for details.

INSTALLATION

./yii migrate/up --migrationPath=@auth/migrations

URLs

  • Login: yourhost/auth/default/login
  • Logout: yourhost/auth/default/logout
  • Sign-up: yourhost/auth/default/signup
  • Reset Password: yourhost/auth/default/reset-password
  • User management: yourhost/auth/user/index
  • User profile: yourhost/auth/profile/view

Flattr this git repo

Something went wrong with that request. Please try again.