Download the PHP package phprsa/id-validator without Composer
On this page you can find all versions of the php package phprsa/id-validator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phprsa/id-validator
More information about phprsa/id-validator
Files in phprsa/id-validator
Package id-validator
Short Description Professional South African RSA ID Number Validation Library with Luhn algorithm, date validation, and component extraction
License MIT
Homepage https://github.com/phprsa/id-validator
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 id-validator
PHP RSA ID Validator
A lightweight PHP library for validating South African ID numbers. It performs full structural checks, validates birth dates (with correct century resolution), determines gender, identifies citizenship, and verifies the Luhn check digit. Ideal for forms, authentication systems, HR platforms, and any application requiring reliable South African ID verification.
Features
- Validates full RSA ID format (
YYMMDDSSSSCAZ) - Birth date extraction with century detection that correctly rejects future-dated interpretations
- Gender identification based on the sequence number
- Citizen vs. permanent resident status
- Full Luhn algorithm check digit validation
- Typed, immutable result object — no more guessing at array keys
Requirements
- PHP 8.1 or later
Installation
Using Composer
Manual load
If you're not using Composer, require the three source files directly
(in this order, since RsaIdValidator depends on the other two):
Usage
validate() returns an IdValidationResult object rather than a bare array,
so your editor can autocomplete the available fields and typos fail at
static-analysis time instead of silently returning null:
| Property | Type | Notes |
|---|---|---|
valid |
bool |
Always present |
idNumber |
?string |
Present only when valid is true |
dateOfBirth |
?DateTimeImmutable |
Present only when valid is true |
gender |
?Gender |
Backed enum: Gender::Male / Gender::Female |
citizenship |
?Citizenship |
Backed enum: Citizenship::Citizen / Citizenship::PermanentResident |
checkDigit |
?int |
Present only when valid is true |
error |
?string |
Present only when valid is false |
Quick boolean check
If you just need a yes/no answer, skip the object entirely:
Migrating from v1.x (array-based results)
v1.x returned a plain associative array. If you're not ready to switch call
sites over to the typed properties yet, toArray() reproduces the old shape:
A note on century ambiguity
An RSA ID number only stores a two-digit year, so a year like 35 is
genuinely ambiguous between 1935 and 2035 — the ID number alone can't tell
you which. This library resolves that the only sound way it can: a
candidate century is rejected outright if it would place the birth date in
the future, and otherwise accepted if it produces a plausible age (0–122
years). Where both centuries remain plausible, 2000s is preferred, since
that's the more common case in practice. If your application needs different
disambiguation rules (e.g. always assuming the older century for a
particular use case), you'll want to layer that logic on top of
dateOfBirth yourself.
Demo
demo/index.php is a small self-contained web page for manual testing. It's
for demonstration only — remove it or put it behind auth before deploying
anywhere near production, since it accepts raw ID numbers over POST.
Running the tests
All sample IDs in the test suite are real, independently-verified numbers
(checked against the Luhn variant documented in
RsaIdValidator::validateLuhn()) — not placeholders.
License
MIT
