jijoel/sanitization-filters

Data sanitizer filters for use with waavi/sanitizer

v0.3.1 2019-02-23 20:07 UTC

Requires

• illuminate/support: ^5.0
• nesbot/carbon: ~1.0|~2.0
• waavi/sanitizer: ^1.0.8

Requires (Dev)

• phpunit/phpunit: ~8.0

MIT

• Joel Hatch

• input
• laravel
• sanitation
• input filter
• input sanitation
• input sanitizer
• transform input

README

This is a collection of custom sanitization filters to be used in conjunction with Waavi/Sanitizer.

Example

Given a data array with the following format:

$data = [
    'first_name'    =>  'john',
    'last_name'     =>  '<strong>DOE</strong>',
    'email'         =>  '  [e-mail]',
    'birthdate'     =>  '06/25/1980',
    'jsonVar'       =>  '{"name":"value"}',
];

We can easily format it using our Sanitizer and the some of Sanitizer's default filters:

use \Waavi\Sanitizer\Sanitizer;

$filters = [
    'first_name'    =>  'trim|escape|capitalize',
    'last_name'     =>  'trim|escape|capitalize',
    'email'         =>  'trim|escape|lowercase',
    'birthdate'     =>  'trim|format_date:m/d/Y, Y-m-d',
    'jsonVar'       =>  'cast:array',
];

$sanitizer  = new Sanitizer($data, $filters);
var_dump($sanitizer->sanitize());

Which will yield:

[
    'first_name'    =>  'John',
    'last_name'     =>  'Doe',
    'email'         =>  '[e-mail]',
    'birthdate'     =>  '1980-06-25',
    'jsonVar'       =>  '["name" => "value"]',
];

Available Filters

Filter	Description
alpha	Alphabetic characters only (a-z)
address	Street Addresses
country	Capitalize country name (or abbreviation)
date	Date values
limit	Trims the input at a given limit
lower	Converts the given string to all lowercase
money	Sets the given string to two decimal places
name	Converts the string to a Proper Name (eg, Foo O'Bar)
number	Returns the numeric part of the given string
phone	A US Telephone number
proper	Converts the given string to Proper (Title) Case
state	Capitalize state name (or abbreviation)
strip	Remove some problematic characters from input. These include: ' ? ; -- / &
title-case	Converts the given string to Title Case
upper	Converts the given string to all uppercase
zip	Converts to a US zip code

Installation

Install with composer:

composer require jijoel/sanitization-filters

We also include a Laravel service provider, via auto-discovery. For versions of Laravel prior to 5.5, add it to your providers array in config/app.php:

'providers' => [
    ...
    Waavi\Sanitizer\Laravel\SanitizerServiceProvider::class,
    Jijoel\Sanitizer\Laravel\SanitizerServiceProvider::class,
];

Usage

It's recommended to sanitize your data in a FormRequest object before applying rules. The Waavi/Sanitizer package includes a SanitizesInput trait, which handles this automatically for you.

use Waavi\Sanitizer\Laravel\SanitizesInput;

class MyFormRequest extends FormRequest
{
    use SanitizesInput;

    public function filters()
    {
        return [
            'name' => 'trim|escape|name',
            'email' => 'trim|escape|lower',
        ];
    }

    public function rules()
    {
        return [
            'name' => 'required',
            'email' => 'required|email',
        ];
    }

Please note that at this time, in order for this to work, the Sanitizer facade must exist.