andheiberg/verify

A simple authentication bundle for Laravel 4. It features roles, permissions, password salting and is fully extendable.

Verify - Laravel 4 Auth Package

A simple role/permission authentication package for Laravel 4, _(*1)

• Role/permission based authentication
• Exceptions for intelligent handling of errors
• Configurable/extendable

Installation

Add Verify to your composer.json file:, _(*2)

"require": {
    "andheiberg/verify": "2.0.*"
}

Now, run a composer update on the command line from the root of your project:, _(*3)

composer update

Registering the Package

Add the Verify Service Provider to your config in app/config/app.php:, _(*4)

'providers' => array(
    'Toddish\Verify\VerifyServiceProvider'
),

Change the driver

Then change your Auth driver to 'verify' in app/config/auth.php:, _(*5)

'driver' => 'verify',

You may also change the 'model' value to 'Toddish\Verify\Models\User' if you want to be able to load Verify's User model when using Auth::user()., _(*6)

Alternatively, you can simply create your own User model, and extend Verify's:, _(*7)

use Toddish\Verify\Models\User as VerifyUser;

class User extends VerifyUser
{
    // Code
}

Publish the config

Run this on the command line from the root of your project:, _(*8)

php artisan config:publish toddish/verify

This will publish Verify's config to app/config/packages/toddish/verify/., _(*9)

Migration

Now migrate the database tables for Verify. Run this on the command line from the root of your project:, _(*10)

php artisan migrate --package="toddish/verify"

You should now have all the tables imported, complete with a sample user, called admin, with a password of password., _(*11)

Usage

The package is intentionally lightweight. You add Users, Roles and Permissions like any other Model., _(*12)

$user = new Toddish\Verify\Models\User;
$role = new Toddish\Verify\Models\Role;
$permission = new Toddish\Verify\Models\Permission;

etc., _(*13)

All models are in the namespace 'Toddish\Verify\Models\'., _(*14)

The relationships are as follows:, _(*15)

• Roles have many and belong to Users
• Users have many and belong to Roles
• Roles have many and belong to Permissions
• Permissions have many and belong to Roles

Relationships are handled via the Eloquent ORM, too:, _(*16)

$role->permissions()->sync(array($permission->id, $permission2->id));

More information on relationships can be found in the Laravel 4 Eloquent docs., _(*17)

Basic Examples

// Create a new Permission
$permission = new Toddish\Verify\Models\Permission;
$permission->name = 'delete_user';
$permission->save();

// Create a new Role
$role = new Toddish\Verify\Models\Role;
$role->name = 'Moderator';
$role->level = 7;
$role->save();

// Assign the Permission to the Role
$role->permissions()->sync(array($permission->id));

// Create a new User
$user = new Toddish\Verify\Models\User;
$user->username = 'Todd';
$user->email = 'todd@toddish.co.uk';
$user->password = 'password'; // This is automatically salted and encrypted
$user->save();

// Assign the Role to the User
$user->roles()->sync(array($role->id));

// Using the public methods available on the User object
var_dump($user->is('Moderator')); // true
var_dump($user->is('Admin')); // false

var_dump($user->can('delete_user')); // true
var_dump($user->can('add_user')); // false

var_dump($user->level(7)); // true
var_dump($user->level(5, '<=')); // false

Documentation

For full documentation, have a look at http://docs.toddish.co.uk/verify-l4., _(*18)