Download the PHP package rydurham/sentinel without Composer

Sentinel: Sentry Implementation for Laravel

This package provides an implementation of Sentry 2 for Laravel. By default it uses Bootstrap 3.0, but you can make use of whatever UI you want. It is intended to be a very simple way to get up and running with User access control very quickly. For simple projects you shouldn't need to do much more than drop it in and dial in the configuration.

The auth package has been deprecated. If you are using it in production you should upgrade to . This package will also eventually be deprecated. Do not use this package if you are starting a fresh application.

Important There are two PHP packages named "Sentinel". This is , not . The key difference is that this package is intended to be an implementation of Sentry v2, whereas Cartalyst released what would have been Sentry v3 under the name . The instructions below are specifically for , make sure you are using the right package before proceeding.

If you are looking for a quick way to get up and running with . I have created a bridge package that may be helpful. If you are starting a new Laravel project, I recommend using that package instead of this one.

Releases There are several versions of this package, each intended for different versions of the Laravel framework.

Laravel 5 Instructions

Install the Package Via Composer:

Make sure you have configured your application's Database and Mail settings.

This package uses "package discovery" to automatically register it's service provider with your application.

Register the Middleware in your file:

Publish the Views, Assets, Config files and migrations:

You can specify a "theme" option to publish the views and assets for a specific theme:

Run to see the currently available themes.

Run the Migrations Be sure to set the appropriate DB connection details in your file.

Note that you may want to remove the and migrations that are provided with a new Laravel 5 application.

Seed the Database:

More details about the default usernames and passwords can be found here.

Set a "Home" Route.

Sentinel requires that you have a route named 'home' in your file:

Basic Usage

Once installed and seeded, you can make immediate use of the package via these routes:

• • For user management. Only available to admins
• • For group management. Only available to admins.

Sentinel also provides middleware which you can use to prevent unauthorized access to your application's routes & methods.

• • Require users to have an active session
• • Block access for everyone except users who have the 'admin' permission.
• • Limit access to members of a certain group. The group name is case sensitive. For example:
• • Redirect users who have an active session

Advanced Usage

This package is intended for simple sites but it is possible to integrate into a larger application on a deeper level:

• Turn off the default routes (via the config) and manually specify routes that make more sense for your application
• Create a new User model that extends the default Sentinel User Model . Be sure to publish the Sentinel and Sentry config files (using the command) and change the User Model setting in the Sentry config file to point to your new user model.
• Inject the and/or the classes into your controllers to have direct access to user and group manipulation. You may also consider creating custom repositories that extend the repositories that come with Sentinel.

It is not advisable to extend the Sentinel controller classes; you will be better off in the long run creating your own controllers from scratch.

Using Sentinel in Tests

If you find yourself in the situation where you want to do tests with user logged in, go to your ` tests/TestCase.php and add this method:

You can then start testing your application with user logged in, as such:

Documentation & Questions

Check the Wiki for more information about the package:

• Configuration Options
• Events & Listeners
• Seed & Migration Details
• Default Routes

Any questions about this package should be posted on the package website.

Localization

Sentinel has been translated into several other languages, and new translations are always welcome! Check out the Sentinel Page on CrowdIn for more details.