deligoez / tckimlikno
Turkish Identification Number Verification & Validation Package for Laravel
Installs: 8 342
Dependents: 1
Suggesters: 0
Security: 0
Stars: 9
Watchers: 1
Forks: 3
Open Issues: 0
Requires
- php: ^7.4 | ^8.0
- fakerphp/faker: ^1.13
- illuminate/support: ^8.0 | ^9.0
- ricorocks-digital-agency/soap: ^1.1
Requires (Dev)
- mockery/mockery: ^1.4
- orchestra/testbench: ^6.17
- phpunit/phpunit: ^9.5
This package is auto-updated.
Last update: 2023-01-25 22:07:43 UTC
README
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 ye@deligoz.me instead of using the issue tracker.
Credits
License
MIT. Please see the license file for more information.