PHP Valida RUT: Validate RUT Chilean numbers

[![Latest Stable Version](https://poser.pugx.org/unreal4u/rutverifier/v/stable.png)](https://packagist.org/packages/unreal4u/rutverifier)
[![Build Status](https://travis-ci.org/unreal4u/rutverifier.png?branch=master)](https://travis-ci.org/unreal4u/rutverifier)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/unreal4u/rutverifier/badges/quality-score.png?s=41b9a0c72279222d0e5172565ea4f9944b6c0e5e)](https://scrutinizer-ci.com/g/unreal4u/rutverifier/)
[![Code Coverage](https://scrutinizer-ci.com/g/unreal4u/rutverifier/badges/coverage.png?s=bf9bcc36803a605d4f7d2e642c1b2648af94cb2c)](https://scrutinizer-ci.com/g/unreal4u/rutverifier/)
[![License](https://poser.pugx.org/unreal4u/rutverifier/license.png)](https://packagist.org/packages/unreal4u/rutverifier)

rutverifier.php
======

Credits
--------

This class is made by unreal4u (Camilo Sperberg) [Homepage](http://unreal4u.com/)

About this class
--------

* Can be used to verify chilean RUT (Rol único tributario) or RUN (Rol único nacional). (<a href="http://www.registrocivil.cl/PortalOI/html/faq/Cod_Area_4/Cod_Tema_30/pregunta_155.html">Difference</a> [spanish])
* Will give you some information, such as the RUT/RUN being consulted is an enterprise (RUT) or a natural person (RUN).
* Allows you to make use of a blacklist (Useful for known frauders).
* Will also format the RUT/RUN into the correct format.
* Can deliver also a pure (more basic) Javascript coded version to verify the validity of a RUT/RUN

Detailed description
---------

This package will do all kinds of things you can do with a RUT or RUN, such as:

* Verifying that it is valid.
* Finding out whether it is a RUT or a RUN.
* Format it to the correct format to use / store / work with

Basic usage
----------

<pre>include('src/unreal4u/rutverifier.php');
$rutVerifier = new unreal4u\rutverifier();
$result = $rutVerifier->isValidRUT('30.686.957-4');
</pre>
* Congratulations! Result does now contain true or false depending on the RUT/RUN being valid or not.
* **Please see examples for more options and advanced usage**

Composer
----------

This class has support for Composer install. Just add the following section to your composer.json with:

<pre>
{
    "require": {
        "unreal4u/rutverifier": "@stable"
    }
}
</pre>

Now you can instantiate a new rutverifier class by executing:

<pre>
require('vendor/autoload.php');

$rutverifier = new unreal4u\rutverifier();
</pre>

Don't forget to do a <code>composer.phar install</code> or download and include
<code>http://packagist.org/unreal4u/rutverifier-js</code> manually

Pending
---------
* Class will throw exceptions instead of adding silently to an internal error array
* Native i18n support

Version History
----------

* 1.0 :
    * Initial version
* 1.1:
    * PHPUnit testing
    * Documentation improved (Created this README actually)
    * More examples
    * Solved some bugs
* 1.2:
    * Compatibility with composer
    * Better documentation
* 1.2.1:
    * Real compatibility with composer
* 1.2.2:
    * Minor bugs in documentation
* 1.2.4:
    * Documentation
    * Better PHPUnit tests
    * Fixed a bug related to cache and blacklisting
    * Included PHPDocumentor to src code
* 1.2.6:
    * Excluded PHPDocumentation
* 1.2.8:
    * Travis-CI support
    * Very small optimization on Javascript function
    * Began deprecating some old naming conventions
* 2.0.0:
    * Removed c_javascript function
    * Standarized data type on return for all functions, no more mixed types
    * Updated PHPUnit dependency to latest stable version
    * Will now test PHP 5.3 in Travis-CI as well
    * Class will now sprintf into the error array in preparation for later i18n implementation
* 2.1.0:
    * Now checking JavaScript code with grunt
* 2.2.0:
    * This class has now a dependency on unreal4u/rutverifier-js, downloadable on packagist
    * Cleaned up javascript code that had nothing to do with PHP

Contact the author
-------

* Twitter: [@unreal4u](http://twitter.com/unreal4u)
* Website: [http://unreal4u.com/](http://unreal4u.com/)
* Github:  [http://www.github.com/unreal4u](http://www.github.com/unreal4u)