freshwork/chilean-bundle

A PHP composer package with Chilean validations, common variables, etc. (RUT, IVA, ETC). Ready for Laravel 5. Grande chile ctm :)

Friday, July 6, 2018
by freshwork
Repository
4 Watchers
37 Stars
5,694 Installations

PHP
0 Dependents
0 Suggesters
7 Forks
0 Open issues
18 Versions
10 % Grown

The README.md

Chilean Bundle

A PHP composer package with Chilean validations, common variables, etc. Viva Chile Mier..., _(*1)

This package includes:

R.U.T. validation
More functions coming soon...

Installation

Step 1: Composer

From the command line, run:, _(*2)

composer require freshwork/chilean-bundle

If you're not using Laravel, you are done., _(*3)

Step 2: Laravel Service Provider

If you're using Laravel 5.5 this package supports Auto-Discovery. So you can skip this step., _(*4)

For Laravel 5.4 or below, _(*5)

Append this line to your providers array in your config/app.php file:, _(*6)

'providers' => [
    ...
    Freshwork\ChileanBundle\Laravel\ChileanBundleServiceProvider::class
];

and you can add the RUT Facade, _(*7)

'aliases' => [
    ...
    'Rut'   => Freshwork\ChileanBundle\Laravel\Facades\Rut::class
];

Usage

The Basics

You can use the RUT object, but I recommend using the Rut::parse() method., _(*8)

include('vendor/autoload.php'); //Enable composer autloading if not using laravel
use Freshwork\ChileanBundle\Rut;

$rut = new Rut('11.111.111', '1');
$rut->validate(); //true

(new Rut('12345678', '5'))->validate(); //true

The `parse()` method

Is the recommended way of using the object. It will automatically separate the Verification Number (Dígito verrificador) and the rest of the number., _(*9)

    Rut::parse('11.111.111-1')->validate(); //true
    Rut::parse('11111111-1')->validate(); //true
    Rut::parse('12.345.678-5')->validate(); //true
    Rut::parse('123456785')->validate(); //true
    Rut::parse('1.23.45.6.7.8-5')->validate(); //true. It escapes all the dots and dashes.

The `set()` method

This is a shortcut for (new Rut($number, $vn)), _(*10)

Rut::set('10.123.123', '5'); //return true

The `validate()` & `isValid()` method

validate() is an alias of isValid(), _(*11)

Rut::parse('12345678-5')->isValid(); //true

Invalid Formatted R.U.T.

if the R.U.T. is invalid, it will return false, _(*12)

Rut::parse('12.345.678-9')->validate(); //false

Invalid Formatted R.U.T.

if the R.U.T. has a wrong format, it will throw an Freshwork\ChileanBundle\Exceptions\InvalidFormatException, _(*13)

Rut::parse('12.3k5.6L8-9')->validate(); //throw Freshwork\ChileanBundle\Exceptions\InvalidFormatException
Rut::set('12.345.678')->validate(); // throw exception. We didn't set the verification number

`Quiet` mode

You can prevent that the object throws an InvalidFormatException, so validate() will just return false, using the quiet() mehtod., _(*14)

Rut::parse('12.3k5.6L8-9')->quiet()->validate(); //return false. No exception

You can re-enable exceptions with use_exceptions(), _(*15)

The `calculateVerificationNumber()` method

You can get the correct verification number of a RUT. Note that the we are passing just one argument to the set() method. We are not defining a verification number., _(*16)

Rut::set('12.345.678')->calculateVerificationNumber(); //return 5
Rut::set('12.345.678-9')->calculateVerificationNumber(); //return 5
Rut::parse('12.345.678-9')->calculateVerificationNumber(); //return 5

Esta clase se basa en está simple, pero eficiente función: http://www.dcc.uchile.cl/~mortega/microcodigos/validarrut/php.php, _(*17)

The `format()` method

Return the Rut object as string with a definied format., _(*18)

Rut::parse('123456789')->format(); //return 12.345.678-9. It doesn't validates. It just formats.
Rut::parse('123456785')->format(Rut::FORMAT_COMPLETE); //return 12.345.678-5.
Rut::parse('123456785')->format(Rut::FORMAT_WITH_DASH); //return 12345678-5.
Rut::parse('123456785')->format(Rut::FORMAT_ESCAPED); //return 123456785.
Rut::parse('12.345.678-5')->format(Rut::FORMAT_ESCAPED); //return 123456785.

The `normalize()` method

If you are saving RUTs in the database, I recommend saving the normalized rut string. This method is an alias of ->format(Rut::FORMAT_ESCAPED), _(*19)

Rut::parse('12.345.678-5')->normalize(); //return '123456785'

The `toArray()` method

Return the Rut object as string with a definied format., _(*20)

Rut::parse('12.345.678-5')->toArray(); //return ['12345678', '5']

The `fix()` method

Fix the current RUT. It will take the number part of the RUT (without verification number) and it will calculate what's the correct verification number for that RUT and then updates the verification number with this result., _(*21)

Rut::parse('12.345.678-9')->fix()->format(); //return '12.345.678-5'

//Set a new rut without setting any verification number
Rut::set('12345678')->fix()->format(); //return '12.345.678-5'

//Set a new rut with an invalid verification number that will be replaced
Rut::set('12345678', '6')->fix()->format(); //return '12.345.678-5'

Rut::parse('12.345.678-9')->validate(); //return false
Rut::parse('12.345.678-9')->fix()->validate(); //return true

The `vn()` and `number()` method

You can set and get the RUT number and verification number with this methods. If no argumen are passed to this methods, it will return the corresponding value. Otherwise, it sets the value., _(*22)

//Getter
Rut::parse('12.345.678-9')->vn(); //return '9'
Rut::parse('12.345.678-9')->number(); //return '12345678'

//Setter
Rut::parse('12.345.678-9')->vn('7')->format(); //return '12.345.678-7'
Rut::parse('12.345.678-9')->number('11111111')->format(); //return '11.111.111-9'
Rut::set()->number('12.345.678')->vn('9')->format() //return '12.345.678-9'

Laravel

Validations

If you're using the service Provider, you can validate ruts usign the validation system of Laravel using the cl_rut validation., _(*23)

...
class ClientController extends Controller{
    ...
    use ValidateRequests;
    ...
    public function store(Request $request) {
        $this->validate($request, [
            `nombre' => 'required|min:2',
            'email' => 'required|email',
            'rut'   => 'required|cl_rut'
        ]);
        //Do stuff
    }
}

Examples

RUT Generator, _(*24)

<?php

use \Freshwork\ChileanBundle\Rut;

//We loop 10 times
for($i = 0; $i < 10; $i++)
{
    //generate random number between 1.000.000 and 25.000.000
    $random_number = rand(1000000, 25000000);

    //We create a new RUT wihtout verification number (the second paramenter of Rut constructor)
    $rut = new Rut($random_number);

    //The fix method calculates the verification number
    echo $rut->fix()->format() . " \n";
}
//Output (random)

17.062.139-5
18.815.969-9
14.287.543-8
13.864.006-K
16.724.081-K
20.465.345-3
13.294.672-8
11.102.906-7
8.333.479-7
7.661.557-8

This generates ten random RUT's between 1.000.000 and 25.000.000, _(*25)

Even a shorter syntaxis:, _(*26)

<?php
for($i = 0; $i < 10; $i++)
    echo \Freshwork\ChileanBundle\Rut::set(rand(1000000, 25000000))->fix()->format() . "\n";

Licencia y Postalware

Puedes usar este paquete gratuitamente sin ninguna restricción, aunque como está de moda, implementamos una licencia 'Postalware'. Si usas este paquete en producción y te gusta como funciona, Agradeceríamos bastante si nos envías una postal de tu ciudad/comuna, una nota de agradecimiento o un súper8., _(*27)

Dirección Nombre: Gonzalo De Spirito Providencia 229, Providencia. Chile,, _(*28)

Testing

You can run the tests as ./vendor/bin/pest, _(*29)

Contributing

Please, feel free to contact me at gonzalo@freshworkstudio.com.-, _(*30)

The Versions

06/07 2018

dev-master

9999999-dev

A PHP composer package with Chilean validations, common variables, etc. (RUT, IVA, ETC). Ready for Laravel 5. Grande chile ctm :)

library chilean-bundle

A PHP composer package with Chilean validations, common variables, etc. (RUT, IVA, ETC). Ready for Laravel 5. Grande chile ctm :)

freshwork/chilean-bundle

The README.md

Chilean Bundle

This package includes:

Installation

Step 1: Composer

Step 2: Laravel Service Provider

Usage

The Basics

The parse() method

The set() method

The validate() & isValid() method

Invalid Formatted R.U.T.

Invalid Formatted R.U.T.

Quiet mode

The calculateVerificationNumber() method

The format() method

The normalize() method

The toArray() method

The fix() method

The vn() and number() method

Laravel

Validations

Examples

Licencia y Postalware

Testing

Contributing

The Versions

dev-master

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

2.1.2

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

2.1.1

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

2.0.11

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

by Eduardo Aguad

2.1.0

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

by Eduardo Aguad

2.0.10

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

by Eduardo Aguad

2.0.9

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

by Eduardo Aguad

2.0.8

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

by Eduardo Aguad

2.0.7

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

2.0.6

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

dev-develop

The Requires

The Development Requires

by Gonzalo De Spirito | Freshwork Studio Chile

2.0.5

The `parse()` method

The `set()` method

The `validate()` & `isValid()` method

`Quiet` mode

The `calculateVerificationNumber()` method

The `format()` method

The `normalize()` method

The `toArray()` method

The `fix()` method

The `vn()` and `number()` method