Download the PHP package vonlab/kz-iin without Composer
On this page you can find all versions of the php package vonlab/kz-iin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vonlab/kz-iin
More information about vonlab/kz-iin
Files in vonlab/kz-iin
Package kz-iin
Short Description A library for generating and validating Kazakh Individual Identification Numbers (IIN).
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 kz-iin
KzIIN Library
This library provides tools for validating, parsing, and generating Kazakhstan Individual Identification Numbers (IIN).
About Kazakhstan IIN
In Kazakhstan, the Individual Identification Number (IIN) is a unique identifier assigned to individuals. The IIN is composed of 12 digits, where each digit represents specific information about the individual, such as the date of birth, gender, and a unique identifier for individuals born on the same date. More detailed information about the structure and purpose of the IIN can be found here.
Features
- Validate Kazakhstan IINs
- Parse Kazakhstan IINs to extract useful information
- Generate valid Kazakhstan IINs
- Exception handling for various validation errors
Installation
You can install the package via composer:
Usage
Validating an IIN
To validate an IIN, use the IinValidator class.
With Exception Handling
Without Exception Handling
IIN Generation
To generate an IIN, use the IinGenerator class.
Parsing an IIN
To parse an IIN, use the IinParser class.
Additional Information
Exception Classes
The library provides specific exception classes to handle various validation errors:
InvalidIinLengthExceptionInvalidIinCharacterExceptionInvalidBirthDateExceptionInvalidCenturyGenderDigitExceptionInvalidControlDigitExceptionInvalidIinFormatException
Utility Classes
The library includes utility classes for internal calculations and date handling:
IinHelper: Contains methods for checksum calculations and century/gender digit extraction.DateConverter: Utility class for date format conversions.
Docker Support
A minimal docker-compose.yml is included for setting up the development environment.
Testing
The library includes a comprehensive set of unit tests. To run the tests, use the following command:
Changelog
Please see CHANGELOG for more information on what has changed recently.
Support
If you encounter any issues or have questions, feel free to open an issue on GitHub.
License
The MIT License (MIT). Please see License File for more information.
