devsmo/php-hetu

PHP Hetu validator. Hetu stands for Henkilötunnus aka Finnish Social Security Number

php-hetu

, _(*1)

Finnish Social Security number validator., _(*2)

This simple class validates social security numbers and provides methods for checking birthdate, age and gender based on the 'hetu'., _(*3)

Requirements

• PHP >= 8.0

Installation

The recommended way is to install the lib through Composer., _(*4)

composer require devsmo/php-hetu

Or you can add this to your composer.json, _(*5)

{
    "require": {
        "devsmo/php-hetu": "^1.0"
    }
}

Usage

The hetu class creates an immutable value object. You can initialize the object in two ways:, _(*6)

<?php

$hetu = Devsmo\Hetu::create('041281-981T');

if ( $hetu ) {
    echo "It's valid";
}
else {
    echo "It's not valid...";
}

Or if you want to catch possible errors:, _(*7)

<?php

try {
    $hetu = new Devsmo\Hetu('041281-981T');
}
catch (\InvalidArgumentException $e){
    $msg = $e->getMessage();
}

The class has three methods:, _(*8)

<?php
$age = $hetu->getAge(); // 35

$date_of_birth = $hetu->getDateStr(); // 1981-12-04

$gender = $hetu->getGender(); // male

Contribution

Feel free to contribute! Just create a new issue or a new pull request., _(*9)

License

This library is released under the MIT License., _(*10)