Download the PHP package defrostedtuna/alnus without Composer
On this page you can find all versions of the php package defrostedtuna/alnus. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package alnus
Alnus
Alnus is a library to add roles and permissions to a Laravel project and is built to work alongside Laravel's Gate system. Alnus hill is a reference to something called, wait for it... Gate.
Quick Installation
Composer is the best way to install Alnus.
Otherwise you could just place it in your composer.json file.
Service Provider
After installing, you must place the service provider into config/app.php
Migrations
Migrations have been made to incorporate this into an application out of the box.
Simply run php artisan migrate to have the migration tables created.
Note: By default, Alnus is set to migrate a uuid field as a foreign key in reference to the users table.
Personally, I use the package webpatser/laravel-uuid for this matter. Here is a very good article on implementing uuids into a Laravel project.
Trait
To finish setup, attach the RolesAndPermissions trait onto your user model.
Note: Alnus is configured to look for the user model under the App\Models directory. If you would like to change this, publish the config file and point config/alnus.php to a location of your choosing.
Usage
Once the RolesAndPermissions trait has been placed onto the user model, you will have access to a variety of functions.
Some examples:
What if you want to check for roles and permissions?
Creating Role and Permissions
Roles and permissions are actually quite simple. They consist of a name, and a label. To create one, simply assign both of these attributes to the record.
Finally, attach the permission to the role.
Integration with Laravel's Gate system
I mentioned that this is designed to be easily used with Laravel's gate system, lets see an example of how I typically do this.
Assuming we have three users, the first user has the role of 'administrator' and has full control of the site. The second is a 'moderator' who has permission to update all posts. Finally, our third user will have no permissions and can only update thier own post.
I prefer to use policies when working with a project. I'll use policies in this example, however you are free to define these however you wish.
As you can see in this example, we are able to check three different levels of access. First, the administrator is given access prior to running the check. The moderator who has the ability to update posts is given access. Our third user would only be given access if they are the owner of the post, locking them out from changing a post belonging to another user.
That's pretty much it. This is fairly straightforward and most of the gate checks will mimic the permission names, allowing for super easy use. Bonus is that you'll be able to perform additional logic for the special cases, such as checking to see if a user owns a post without needing to muck up your code too much.
