keithtait/laravel_ease_auth

Ease Authentication for Laravel 4

dev-master 2014-07-17 15:05 UTC

Requires

• php: >=5.3.0
• illuminate/support: 4.x

MIT

• keithtait

• laravel
• laravel4
• ease

README

Ease authentication for the Laravel PHP framework.

This is designed to be a drop-in replacement for the built-in Laravel Auth module.

The current version is for use with laravel 4.1.*

A review is needed in respect of changes to the standard User model in Laravel 4.2

Installation

Add the following to the require section of your project's composer.json:

"keithtait/laravel_ease_auth": "dev-master"

Update the project's dependencies:

$ composer update

Add the provider to app/config/app.php, replace:

'Illuminate\Auth\AuthServiceProvider'

with

'SPS\EaseAuth\AuthServiceProvider'

Add the alias to app/config/app.php, replace

'Illuminate\Support\Facades\Auth'

with

SPS\EaseAuth\AuthFacade'

Configuration

The EASE Auth module requires very simple configuration:

1. Copy the 'ease' settings in the example file _configexample.php to app/config/auth.php

2. Add the 'ease' filter in the example file _filtersexample.php to app/filters.php

Usage

Using the EASE Auth module is almost exactly the same as the usual Illuminate Auth that ships with Laravel. The major difference is that it does not process user passwords.

It accepts that once a user has been authenticated by EASE all it need do is check that the current user is authorised to access resouces within the application.

This also means that there is no need to create either login or password reminder forms.

If you're converting an existing app with Illuminate Auth to EASE Auth the passwords stored for each user will simply be ignored.

Example of routes and controller usage can be found in the included files _routesexample.php and _controllerexample.php