Features :

- Input sources (types) : GET, POST, COOKIE, FILES, SERVER, REQUEST, ENV, SESSION, local variables
- Output format : HTML, URL, RAW, Base64, ISSET, SET
- Format a input variable for an output format
- Cached variables for performance
- Exception or not if variable don't exist (configuration)
- Charset can be specified
- Types and format can be extended
- Change values in superglobal arrays



Usage :

$Input = In::getInstance();
echo $Input->G->RAW->id; // display $_GET['id'] without change
echo $Input->P->HTML->foo; // display $_POST['foo'] for a HTML usage (htmlentities)
echo $Input->C->B64->login; // display $_COOKIE['login'] in base64 encoding
echo $Input->F->RAW->fileName; // display $FILES['fileName']; without change
echo $Input->G->ISSET->id; // display TRUE if $_GET['id'] exists, FALSE otherwise
echo $Input->G->SET->id = 'foo'; // change value of $_GET['id'] et reset caches in instance
echo $Input->HTML($localVariable); // display $localVariable for a HTML usage (htmlentities)



Extend type or format :

- Create a child class which extend In
- Register type / format in register() method like predefined type/format in In
- Implement convert() method for new formats in child class



Configuration :

In::setThrowException(FALSE); // Return NULL instead of throwing exception if a variable don't exists.
In::setCharset('...'); // Set a charset for htmlentities



Warning to the behavior with In cache :

$Input = In::getInstance();
echo $Input->G->RAW->id; // display $_GET['id']
$_GET['id'] = 'new value';
echo $Input->G->RAW->id; // display the OLD value of $_GET['id'] because id is now in cache !
echo $Input->G->HTML->id; // display the NEW value of $_GET['id'] because id has been never asked for HTML format !
$_GET['machin'] = 'valeur';
echo $Input->G->RAW->machin; // display $_GET['machin'] because value has neven been asked, so it's not in cache.
If we use $Input->G->SET->id = 'new value'; instead, this behavior vanish and all works as expected.



History

    2.0 (25/11/2017)

        The class became linked to SALT framework :
    Use of SALT Converters, better performance
    Use of SALT I18n translation
    Remove SQL format

    1.8 (03/03/2017)

    Remove array format feature : Allow this class to process array and scalar values on different ways is error prone.
        We can use RAW for retrieve unformated array values, and a loop for formatting each values.

1.7 (15/08/2016)

    Translate in english

1.6 (31/07/2016) 

    Complete rewrite / simplification
    Removing magic_quotes support (deprecated in 5.3, removed in 5.4)
    Exception thrown for bad usage. setThrowException(FALSE) disable exceptions only for undefined variables.
    Add REQUEST, ENV, SESSION types
    Add SET format

1.5 (10/07/2016) 

    Add SERVER type
    Change URL implementation for using rawurlencode instead of urlencode

1.4 (12/03/2011) 

    Complete rewrite. Removing internal classes.
    New feature : register new type & format
    New format : URL & Base64

1.3 (15/02/2009) 

    Bug fix : magic_quotes_gpc

1.2 

    New feature : Charset for htmlentities
    HTML format : use of ENT_QUOTES

1.1 (29/12/2007) 

    New feature : format local variables