Laravel Binput was created by, and is maintained by Graham Campbell, and is an input protector for Laravel 4.1/4.2. It utilises my Laravel Security package. Feel free to check out the change log, releases, license, demo, api docs, and contribution guidelines.
PHP 5.4+ or HHVM 3.2+, and Composer are required.
To get the latest version of Laravel Binput, simply require "graham-campbell/binput": "~2.0" in your composer.json file. You'll then need to run composer install or composer update to download it and have the autoloader updated.
You will need to register the Laravel Security service provider before you attempt to load the Laravel Binput service provider. Open up app/config/app.php and add the following to the providers key.
'GrahamCampbell\Security\SecurityServiceProvider'
Once Laravel Binput is installed, you need to register the service provider. Open up app/config/app.php and add the following to the providers key.
'GrahamCampbell\Binput\BinputServiceProvider'
You can register the Binput facade in the aliases key of your app/config/app.php file if you like.
'Binput' => 'GrahamCampbell\Binput\Facades\Binput'
Checkout the master branch, installable by requiring "graham-campbell/binput": "~3.0".
Laravel Binput requires no configuration. Just follow the simple install instructions and go!
This is the class of most interest. It is bound to the ioc container as 'binput' and can be accessed using the Facades\Binput facade. There are a few public methods of interest.
The 'all', 'get', 'input', 'only', 'except', and 'old' methods have an identical api to the methods found on the laravel request class accept from they all accept two extra parameters at the end. The first extra parameter is a boolean representing if the input should be trimmed. The second extra parameter is a boolean representing if the input should be xss cleaned. Both extra parameters are default to true.
There are two additional methods added to the public api. The first is a method called 'map' which will remap the output from the 'only' method. The 'map' function requires an associative array as the first parameter. The second method is the 'clean' function. It takes three parameters. The first is the value to be cleaned (it can be an array, and will be recursively iterated over and cleaned), and the final two are trim and clean, which behave in the same way as earlier.
Any methods not found on this binput class will actually fall back to the laravel request class with a dynamic call function, so every other method on the request class is available in exactly the same way it would be on the Laravel request class.
This facade will dynamically pass static method calls to the 'binput' object in the ioc container which by default is the Binput class.
This class contains no public methods of interest. This class should be added to the providers array in app/config/app.php. This class will setup ioc bindings.
Feel free to check out the API Documentation for Laravel Binput.
You may see an example of implementation in Laravel Credentials and Bootstrap CMS.
Apache License
Copyright 2013-2014 Graham Campbell
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.