meditate/twid

Taiwan ID Number validation and maker.

0.2.0 2022-11-14 09:32 UTC

Requires

• php: ^7.0

Requires (Dev)

• illuminate/support: ^5.3
• phpunit/phpunit: ^7.2
• squizlabs/php_codesniffer: ^3.3

MIT

• Wei-Cheng Shi

• validation
• laravel
• identity card
• Taiwan
• laravel-dojo
• meditate
• ID number

README

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

Contents

• Installation
• Usage
  • Basic
  • Facade
  • Laravel validation
• License

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.