deligoez/tckimlikno

Turkish Identification Number Verification & Validation Package for Laravel

v5.1.0 2025-02-27 20:13 UTC

Requires

• php: ^8.1 | ^8.2 | ^8.3 | ^8.4
• guzzlehttp/guzzle: ^7.2.0
• illuminate/support: ^9.0 | ^10.0 | ^11.0 | ^12.0
• ricorocks-digital-agency/soap: ^1.6 | 2.* | 3.*

Requires (Dev)

• fakerphp/faker: ^1.19
• mockery/mockery: ^1.5
• orchestra/testbench: ^7.5 | ^8.0 | ^9.0 | ^10.0
• phpunit/phpunit: ^9.5 | ^10.5 | ^11.0

MIT

• Yunus Emre Deligöz

• package
• validation
• laravel
• tckimlikno
• mernis

README

⚠️ This project is no longer maintained. The NVI public verification services at tckimlik.nvi.gov.tr were discontinued as of 30.09.2025. The validate() method that relied on the NVI API no longer works. The offline verify() method (algorithm-based) still functions, but this package will not receive further updates.

TCKimlikNo

Turkish Identification Number Verification & Validation Package for Laravel.

Installation

Via Composer

$ composer require deligoez/tckimlikno

If you are using Laravel 5.5+, the package will automatically register the service provider for you.

Usage

use Deligoez\TCKimlikNo\TCKimlikNo;


// Verifies Citizenship Number According to it's Algorithm.
// Returns Boolean
TCKimlikNo::verify('12345678901'); // Returns false
TCKimlikNo::verify('10000000146'); // Returns true

// Verifies Parameters and validates all using nvi.gov.tr API
// Returns Boolean
TCKimlikNo::validate('10000000146', 'Yunus Emre', 'Deligöz', '1900')
// Auto Uppercase Disabled
TCKimlikNo::validate('10000000146', 'YUNUS EMRE', 'DELİGÖZ', '1900', false)

Available Laravel Validation Rules

TCKimlikNoVerify

// In a Form Request Class

public function rules()
{
    return [
        'tckimlikno' => ['required', new TCKimlikNoVerify()],
    ];
}

// In a Controller

use Deligoez\TCKimlikNo\Rules\TCKimlikNoVerify;

/**
 * Store a tckn.
 *
 * @param  Request  $request
 * @return Response
 */
public function store(Request $request)
{
    $validatedData = $request->validate([
        'tckn' => ['bail', 'required', new TCKimlikNoVerify()],
    ]);

    // tckn is valid...
}

TCKimlikNoValidate

// In a Form Request Class

public function rules()
{
    return [
        'tckimlikno' => ['required', new TCKimlikNoValidate(
            $name,
            $surname,
            $birthYear,
            $autoUppercase // Optional, defaults to true
        )],
    ];
}

Faker Provider

use Deligoez\TCKimlikNo\Provider\TCKimlikNoFakerProvider;

$faker = Faker\Factory::create();
$faker->addProvider(new TCKimlikNoFakerProvider($faker));

// a Random Valid TCKN
$tckn = $faker->tckn; // 60174067810 

Changelog

Please see the changelog for more information on what has changed recently.

Testing

$ composer test

Contributing

Please see contributing.md for details and a todo list.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Yunus Emre Deligöz
• Turan Karatuğ
• Faruk Can
• Hakan Özdemir
• Mecit
• All Contributors

License

MIT. Please see the license file for more information.