usu/codice-fiscale

A library to calculate and check the validity of the italian fiscal code (codice fiscale)

Installs: 2 902

Dependents: 0

Stars: 9

Watches: 2

Forks: 4

Language: PHP

v1.0.4 2014-11-29 09:49 UTC

README

A library to calculate and check the validity of the italian fiscal code (codice fiscale).

Build Status Latest Stable Version Total Downloads License

Requirements

  • php >= 5.4

Installation

Create a composer.json file with the following content:

{
    "require": {
        "usu/codice-fiscale": "1.0.*"
    }
}

Then run

$ curl -s https://getcomposer.org/installer | php
$ php composer.phar install

You should now have CodiceFiscale installed inside your vendor folder: vendor/usu/codice-fiscale

And an handy autoload file to include in you project: vendor/autoload.php

How to use

<?php
require_once __DIR__ . '/vendor/autoload.php';

use CodiceFiscale\Calculator;
use CodiceFiscale\Checker;

$calc = new Calculator();
$calc->calcola('Nome', 'Cognome', 'M', new \DateTime('1992-03-06'), 'F205');

$chk = new Checker();
if ($chk->isFormallyCorrect('RSSMRA79S18F205J')) {
    print('Codice Fiscale formally correct');
    printf('Birth Day: %s',     $chk->getDayBirth());
    printf('Birth Month: %s',   $chk->getMonthBirth());
    printf('Birth Year: %s',    $chk->getYearBirth());
    printf('Birth Country: %s', $chk->getCountryBirth());
    printf('Sex: %s',           $chk->getSex());
} else {
    print('Codice Fiscale wrong');
}

Testing

The library is fully tested with PHPUnit.

Go to the root folder, install the dev dependencies with composer, and then run the phpunit test suite

$ composer --dev install
$ ./vendor/bin/phpunit