Download the PHP package m3assy/laravelannotation without Composer
On this page you can find all versions of the php package m3assy/laravelannotation. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravelannotation
Laravel Middleware Annotations
Documantation
- Installation
- Usage
- Middleware Annotations
- Integration With Laratrust
- Future Features
Installation
Via Composer
If you are developing your application using Laravel 5.5+, the service providers and facades are registered automatically. If you are using lower versions add those lines to config/app.php
Usage
Now, You don't need to add any trait, the package register a custom controller dispatcher which register middlewares under the hood
Example:
This package built-in auth
middleware annotation so all what you need is to use annotation like so:
If you need to apply middleware over all controller then add you doc block over controller class, and if you need to specify a controller method with middleware then you can add your annotation above the method in its DocBlock.
if you have a middleware with parameters, so you can use the annotation with parentheses and the values syntax.
Creating Middleware Annotation is pretty easy, all what you need is to call our artisan make:annotation
command like so:
This will generate a file like the following:
If you have middleware parameters that required kind of validation then you can override the following method:
Notice: If the given value is invalid the engine will neglect this annotation.
You can also access internal controller properties and methods dynamically like so:
Laratrust Integration
This package is delivered with Implementation For Laratrust ACL Annotations System
.
To start using roles and permissions all what you need is to use the magic annotations in your controllers like so:
Feel free to use Role
and Permission
annotations on the class level and methods level like previous instructions.
Scanning New Roles And Permissions
If you have used any role or permission in its annotation and it does not exist in the acl tables and you need to add them, no need to use any ui or tinker or any type code.
Just use our artisan scan:acl
Command and it will identify automatically what is new in your roles and permissions and detects its type and create new instance for it.
To start scan fire your command like following:
and voila!, We finished :)
If you refreshed any route to a controller contains non-existing role or permission, you will find that it is created and applied.
Future Features
- Implement middleware options.
- Implement Laratrust Teams Feature Annotation.
- Adding more built-in laravel middlewares.
- Implementing magic middleware features for developers to use.
Contributing
Please see contributing.md for details and a todolist.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Mohamed Mostafa
- All Contributors
License
MIT. Please see the license file for more information.