bensondevs/indonesian-ktp

Indonesian KTP (NIK) Validation is a PHP library that checks whether an Indonesian national identity number, called a NIK (Nomor Induk Kependudukan), is structurally valid and refers to a real administrative region. Every Indonesian citizen has a 16-digit NIK on their KTP (identity card) that encodes their province, regency, subdistrict, birth date, gender, and a serial number. This library validates that structure and cross-references the embedded district code against a bundled dataset of Indonesian administrative regions (called wilayah), so no database query is needed at runtime. You can use it as a standalone PHP class by calling a fluent API, for example, checking that a NIK belongs to a male person born on a specific date in Central Java, or you can plug it directly into Laravel's validation system as a custom rule. The library supports chaining optional expectations for birth date, age, gender, province, regency, and subdistrict, and returns either a simple true/false or a detailed result object that tells you exactly which checks passed or failed. It also includes a trait for Laravel's Eloquent ORM that adds NIK-aware methods to a database model. You would use this when building a PHP or Laravel application that collects Indonesian identity numbers, for instance, a government service, a fintech registration form, or an HR system, and needs to reject malformed or nonsensical NIK values before saving them. The library requires PHP 8.3 or higher and Laravel 10 through 13. The full README is longer than what was provided.