erdemkeren / tr-nat-id-num-validator
Validates Turkish National Identification Number
Requires
- php: >=7.1
- illuminate/support: ^5.3
- illuminate/validation: ^5.3
Requires (Dev)
- phpunit/phpunit: >=7.0
README
Bu paket, Laravel 5.3+ uygulamalara TC Kimlik Numarası Doğrulaması özelliği ekler.
İçerik
Kurulum
Paketi composer üzerinden yükleyebilirsiniz:
composer require erdemkeren/tr-nat-id-num-validator
Eğer uygulamanızda otomatik keşif özelliği yoksa;
ardından config/app.php
dosyanıza servis sağlayıcımızı eklemelisiniz.
... 'providers' => [ ... Erdemkeren\Validators\TrNatIdNumValidator\TrNatIdNumValidationServiceProvider::class, ], ...
Kullanım
Validator Olarak Kullanımı
Paket kurulumunu tamamladıktan sonra; herhangi bir doğrulama kullanır gibi kullanabilirsiniz.
NVI'nin soap isteğinin gerçekleştirilebilmesi için; TC Kimlik Numarası ile birlikte sırası ile kullanıcının adını, soyadını ve doğum yılını da vermeniz gerekmektedir.
<?php namespace App\Http\Controllers; use Illuminate\Http\Request; class ExampleController extends Controller { public function index(Request $request) { $this->validate($request, [ 'tr_nat_id_num' => 'required|tr_nat_id_num:Hilmi Erdem,Keren,1990' ]); return "Hello!"; } }
Ozel Olarak Kullanımı
Bu paket, sahnenin arkasında TurkishNationalIdNumberValidator
sınıfını kullanır.
Eğer validation rule değil, özel bir kullanım ihtiyacınız varsa; siz de aynı sınıfı kullanabilirsiniz.
$validator = new TurkishNationalIdNumberValidator(new NviTcKimlikWebServiceRequest()); $result = $validator->validate(new NaturalizationRecord($trNatIdNum, $name, $surname, $birthYear));
Hata Mesajını Ozellestirmek
Verilen hata mesajını değiştirmek isterseniz
resources/lang/{dil}/validation.php
dosyalarına istediğiniz hata mesajını ekleyebilirsiniz:
'tr_nat_id_num' => "Vermek istediğiniz hata mesajı"
Degisiklik Listesi
Lütfen son değişiklikleri görmek için Değişiklik Listesi dosyasını ziyaret ediniz.
Test
Testleri koşmak için composer.json seviyesinde aşağıdaki komut çalıştırılabilir:
$ composer test
Güvenlik
Uygulama, NVI tarafından sağlanan soap isteği şemasını kullanarak; yine NVI tarafından sağlanan bağlantı üzerinden doğrulama isteğinde bulunmaktadır.
Eğer yalnızca iç ağ üzerinde çalışan indoor bir uygulama geliştiriyorsanız; bu paket size uygun değildir.
Katkıda Bulunun
Eğer katkıda bulunmak isterseniz lütfen Katkıda Bulunun dosyasını inceleyin.
Tanıtımlar
Bu paket
epigra/tckimlik paketinin üzerine geliştirilmiştir.
Lisans
The MIT License (MIT). Detaylar için lütfen Lisans Dosyasını inceleyin.