Download the PHP package slwdc/nic-parser without Composer
On this page you can find all versions of the php package slwdc/nic-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download slwdc/nic-parser
More information about slwdc/nic-parser
Files in slwdc/nic-parser
Package nic-parser
Short Description Sri Lankan national identity card number validator
License MIT
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 nic-parser
Sri Lankan National Identity Card Number Parser
A PHP library to parse, validate, and generate valid Sri Lankan national identity card numbers.
Installation
You can install the library easily with composer. Requires PHP 7.4 or later.
Alternaely, you can download the library from github, and manually include the class or integrate into your own autoloader. See the included composer.json file for PSR-4 namespace mappings.
Usage
See the Wikipedia article for the formats used.
Parsing an ID number
<?php
use SLWDC\NICParser\Parser;
require_once __DIR__ . '/../vendor/autoload.php';
/**
* Example 1
*/
$id_number = '862348594v';
$parser = new Parser($id_number);
$parser->getBirthday();// Returns a \DateTime object with the date parsed.
echo $parser->getBirthday()->format('Y-m-d'); // prints "1986-08-22"
echo $parser->getGender(); // Prints "M". M for male, F for female.
echo $parser->getSerialNumber(); // Prints "8594"
/**
* Example 2
*/
$id_number = '19935158154';
$parser = new Parser($id_number);
$parser->getBirthday();// Returns a \DateTime object with the date parsed.
echo $parser->getBirthday()->format('Y-m-d'); // prints "1993-01-15"
echo $parser->getGender(); // Prints "F". M for male, F for female.
echo $parser->getSerialNumber(); // Prints "8154"Validating an ID number
The Parser class throws an exception when you instantiate it with an invalid ID number. Make sure you always catch exceptions on validation.
<?php
use SLWDC\NICParser\Parser;
use SLWDC\NICParser\Exception\InvalidArgumentException;
require_once __DIR__ . '/../vendor/autoload.php';
/* This is an invalid ID number because 499 here is not indicating a valid
birth date */
$id_number = '924998593v';
try {
$parser = new Parser($id_number);
}
catch (\SLWDC\NICParser\Exception\InvalidArgumentException $exception) {
echo $exception->getMessage(); // "Birthday indicator is invalid."
}Depending on the validation error, you will get different messages explaining the situation. All exceptions will be instances of SLWDC\NICParser\Exception\InvalidArgumentException.
I'm no good at writing sample / filler text, so go write something yourself.
Building an NIC number
<?php
use SLWDC\NICParser\Builder;
require_once __DIR__ . '/../vendor/autoload.php';
$birthday = new \DateTime();
$birthday->setDate(1992, 9, 16);
$birthday->setTime(0, 0);
$builder = new Builder();
$builder->setBirthday($birthday);
$builder->setGender('M'); // M for male, F for female.
$builder->setSerialNumber(25738);
echo $builder->getNumber(); // "199226025738". This is the new format.Contribute
All contributions are welcome. If you have any questions, please post an issue in the Github issue queue. For any PRs, we'd appreciate if you can add proper test coverage as well.
Alternative Implementations
- Ksengine/NICParser - A Python implementation
kthxbye.
