Download the PHP package esponsor/dni-validator without Composer
On this page you can find all versions of the php package esponsor/dni-validator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package dni-validator
dni-validator
Validators for Latin American and related national ID documents. Available as both a PHP/Laravel package and a JavaScript/TypeScript package. Both packages implement the same rules and are covered by the same shared test vectors.
Supported documents
| Country | Type | Validation | PHP class | JS import |
|---|---|---|---|---|
| 🇦🇷 Argentina | CUIT/CUIL |
Prefix + modulo-11 check digit | CuitCuilArgentina |
/argentina |
| 🇧🇷 Brazil | CPF |
Two modulo-11 check digits | CpfBrazil |
/brazil |
| 🇧🇷 Brazil | CNPJ |
Two modulo-11 check digits | CnpjBrazil |
/brazil |
| 🇨🇦 Canada | SIN |
Luhn check digit | SinCanada |
/canada |
| 🇨🇱 Chile | RUT |
Modulo-11 check digit | RutChile |
/chile |
| 🇨🇴 Colombia | CC |
Structural only — 8 or 10 digits | CcColombia |
/colombia |
| 🇨🇴 Colombia | NIT |
Structural only — 10 digits, check digit not verified | NitColombia |
/colombia |
| 🇨🇴 Colombia | PASS |
Length only — 2 to 12 characters | PassportColombia |
/colombia |
| 🇪🇨 Ecuador | CI |
Structural only — 10 digits, check digit not verified | CiEcuador |
/ecuador |
| 🇪🇨 Ecuador | RUT |
Structural only — 13 digits, check digit not verified | RutEcuador |
/ecuador |
| 🇪🇨 Ecuador | PASS |
Length only — 8 to 12 characters | PassportEcuador |
/ecuador |
| 🇪🇸 Spain | DNI |
Modulo-23 check letter (covers DNI and NIE) | DniSpain |
/spain |
| 🇲🇽 Mexico | CURP |
Regex + weighted checksum | CurpMexico |
/mexico |
| 🇵🇪 Peru | DNI |
Structural only — 8 digits plus optional verification character | DniPeru |
/peru |
| 🇵🇪 Peru | RUC |
Structural only — 11 digits with a known taxpayer prefix | RucPeru |
/peru |
| 🇺🇸 United States / 🇵🇷 Puerto Rico | SSN |
Structural only — rejects ranges the SSA never issues | SsnUnitedStates |
/united-states |
| 🇺🇾 Uruguay | CI |
Weighted check digit | CiUruguay |
/uruguay |
| 🇺🇾 Uruguay | RUT |
Modulo-11 check digit | RutUruguay |
/uruguay |
Rows marked Structural only or Length only verify shape or length, not a checksum: a well-formed value can still be a number that was never issued.
PHP
Install
Requires PHP ^8.4 and illuminate/contracts ^10|^11|^12|^13.
Direct usage
Every validator exposes validate(). Most also expose clean() (strip formatting) and
format() (apply the country's display format); passport validators only expose validate(),
and RutEcuador has no display format.
Laravel validation rules
Each validator has a matching rule under Esponsor\DniValidator\Rules named after the
validator class (CpfBrazil → CpfBrazilRule). Rules reject non-string values and fail with a
Spanish message.
Registry
Country and document type are matched case insensitively.
Running PHP tests
JavaScript / TypeScript
Install
Requires Node 22+. The published npm package is the repo root package.json; packages/js holds sources and tests only.
Named imports
Import from the country subpath, or from the package root for everything at once. Function
names are suffixed with the country when the same document type exists in several countries
(ciUruguayValidate, ciEcuadorValidate, dniPeruValidate, dniSpainValidate).
Registry
Country and document type are matched case insensitively.
Running JS tests
Contributing
See SECURITY.md.
Shared specs
spec/<cc>/<type>.json is the language-independent contract for each document
(valid, invalid with reasons, optional format_cases, and metadata). Both the PHP and
JS test suites load these files through the registry, so the two runtimes cannot drift apart.
See spec/README.md for the schema.
Behaviour notes
These validators were ported from the eSponsor front-end helper. The following differences are deliberate fixes:
- CL RUT
validate()accepts only digits and conventional separators (.,-, spaces,K). The body is limited to 1–8 digits and the check digit is computed digit-by-digit (no whole-body integer conversion).clean()may still strip other characters when formatting. - BR CPF rejects repeated-digit values such as
111.111.111-11, which pass the checksum but are not issued.CNPJalready rejected them. - UY CI requires 7 or 8 digits before checking the digit. Without the length guard a 12-digit Uruguayan RUT could be accepted as a CI.
- PE DNI requires 8 digits plus an optional verification character, instead of any 8 to 9
characters drawn from
0-9andA-K. - ES DNI/NIE and PE DNI normalise their input (uppercase, punctuation stripped) before validating, like every other validator in the package.
- PE DNI
format()groups 8 digits plus the verification character (12345678-K), matching the documented placeholder.
License
MIT — Copyright (c) 2026 eSponsor
