Laravel Security
Laravel Security was created by, and is maintained by Graham Campbell, and is a port of the security class from CodeIgniter 3 for Laravel 5. This package is best used wrapped in my Laravel Binput package. Feel free to check out the change log, releases, license, and contribution guidelines.
Installation
Laravel Security requires PHP 7. This particular version supports Laravel 5.1, 5.2, 5.3, 5.4, or 5.5 only.
To get the latest version, simply require the project using Composer:
$ composer require graham-campbell/security
Once installed, you need to register the GrahamCampbell\Security\SecurityServiceProvider
service provider in your config/app.php
, or if you're using Laravel 5.5, this can be done via the automatic package discovery.
You can also optionally alias our facade:
'Security' => GrahamCampbell\Security\Facades\Security::class,
Configuration
Laravel Security supports optional configuration.
To get started, you'll need to publish all vendor assets:
$ php artisan vendor:publish
This will create a config/security.php
file in your app that you can modify to set your configuration. Also, make sure you check for changes to the original config file in this package between releases.
There is one config option:
Evil attributes
This option ('evil'
) defines the evil attributes and they will be always be removed from the input.
Usage
Security
This is the class of most interest. It is bound to the ioc container as 'security'
and can be accessed using the Facades\Security
facade. There is one public method of interest.
The 'clean'
method will parse a string removing xss vulnerabilities. This parsing is strongly based on the security class from CodeIgniter 3.
Facades\Security
This facade will dynamically pass static method calls to the 'security'
object in the ioc container which by default is the Security
class.
SecurityServiceProvider
This class contains no public methods of interest. This class should be added to the providers array in config/app.php
. This class will setup ioc bindings.
Further Information
You may see an example of implementation in Laravel Binput.
Security
If you discover a security vulnerability within this package, please send an e-mail to Graham Campbell at graham@alt-three.com. All security vulnerabilities will be promptly addressed.
License
Laravel Security is licensed under The MIT License (MIT).
Laravel Security contains code taken from CodeIgniter, also licensed under The MIT License (MIT).