meditate/twid

Taiwan ID Number validation and maker.

Installs: 7 584

Dependents: 0

Suggesters: 0

Security: 0

Stars: 27

Watchers: 7

Forks: 10

Open Issues: 0

Type:package

0.2.0 2022-11-14 09:32 UTC

This package is not auto-updated.

Last update: 2024-09-30 18:30:47 UTC


README

meditate/twid is PHP Library to validate and make Taiwan ID Number.

Contents

Installation

You can install the package via composer:

composer require meditate/twid

If you are Laravel project, add twid facade in app/config/app.php:

'aliases' => [
	...
    
    'Twid' => Meditate\IdentityCard\Facades\TaiwanIdentityCard::class,
]

Usage

Basic

use Meditate\IdentityCard\TaiwanIdentityCard;

$taiwanIdCard = new TaiwanIdentityCard;

Now, you can use check method to validate ID Number:

$taiwanIdCard->check('A123456789'); // true
$taiwanIdCard->check('A223456789'); // false

Or generate a fake ID Number:

// A123456789
$taiwanIdCard->make();

// B167663827
$taiwanIdCard->make('B');

// A259776352
$taiwanIdCard->make('A', 2);

Facade

Also you can use facade:

Twid::check('A123456789');

Twid::make();

Laravel validation

In Laravel, you can easy use in "form request". Just need to add tw_id rule to the rules method:

public function rules()
{
    return [
        'id_number' => 'tw_id'
    ];
}

License

The MIT License (MIT). Please see License File for more information.