hitobias/twid

Taiwan ID Number validation and maker.

1.0.0 2023-03-20 03:56 UTC

Requires

• php: ^8.0

Requires (Dev)

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

MIT

• Tobias Pan

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

README

hitobias/twid is PHP Library to validate and make Taiwan ID Number. It supports Php 8.1, 8.2

Contents

• Taiwan ID Number validation and maker
  • 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.