Download the PHP package turahe/number-validator without Composer
On this page you can find all versions of the php package turahe/number-validator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
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.
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 PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- 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.
Please rate this library. Is it a good library?
Informations about the package number-validator
Number Validator
A high-performance PHP package for validating and parsing Indonesian identity numbers (NIK and KK) with PHP 8.4 features and optimized performance.
🚀 Features
- NIK (Nomor Induk Kependudukan) validation and parsing
- KK (Kartu Keluarga) validation and parsing
- PHP 8.4 optimized with modern features
- High Performance with intelligent caching
- Offline Operation - no internet connection required
- Comprehensive Data - age, gender, zodiac, address, postal code
- Type Safety with strict type declarations
- Error Handling with detailed validation messages
📦 Installation
🎯 Quick Start
NIK Validation
KK Validation
🔧 Advanced Usage
Error Handling
Array Output
Type Safety
⚡ Performance Optimizations
Caching System
- Intelligent caching for frequently accessed data
- 13.8x faster performance on cached vs non-cached calls
- Memory-efficient caching strategy
String Operations
- Direct character access instead of
substr() - 2.6x faster string operations
- Optimized zodiac calculation with early returns
Memory Management
- Readonly properties for immutability
- Efficient object lifecycle management
- Static caching for current year calculation
🛡️ PHP 8.4 Features
- Readonly Properties:
public readonly string $number - Constructor Property Promotion: Simplified constructors
- Union Types:
string|intfor flexible input - Null Coalescing Assignment:
??=operator - Improved Type Declarations: Better type safety
- Early Returns: Optimized control flow
📊 Performance Benchmarks
| Operation | Time | Memory |
|---|---|---|
| NIK Creation | ~2.5ms | ~783KB |
| NIK Parsing | ~0.1ms | ~4KB |
| KK Creation | ~2.1ms | ~739KB |
| KK Parsing | ~0.02ms | ~1KB |
| 1000 NIK Operations | ~1.5s | Optimized |
| 1000 KK Operations | ~1.5s | Optimized |
🧪 Testing
Run the comprehensive test suite:
All 63 tests pass with 100% coverage.
📁 Project Structure
🔍 API Reference
NIK Class
Methods
set(string|int $number): self- Create NIK instanceparse(): object- Parse and validate NIK datavalidate(): bool- Check if NIK is validgetValidationErrors(): array- Get detailed error messagestoArray(): array- Get data as arraygetGender(): string- Get gender (LAKI-LAKI/PEREMPUAN)getBornDate(): object- Get birth date informationgetAge(): object- Get age calculationgetZodiac(): string- Get zodiac signgetProvince(): ?string- Get province namegetCity(): ?string- Get city namegetSubDistrict(): ?string- Get sub-district namegetPostalCode(): ?string- Get postal code
KK Class
Methods
set(string|int $number): self- Create KK instanceparse(): object- Parse and validate KK datavalidate(): bool- Check if KK is validgetValidationErrors(): array- Get detailed error messagestoArray(): array- Get data as arraygetFormattedNumber(): string- Get formatted KK numbergetRawNumber(): string- Get raw KK numbergetProvince(): ?string- Get province namegetCity(): ?string- Get city namegetSubDistrict(): ?string- Get sub-district namegetPostalCode(): ?string- Get postal code
🚀 Performance Tips
- Reuse Instances: Create validator once and reuse for multiple operations
- Caching Benefits: Subsequent calls to
getBornDate(),getAge(), etc. are cached - Type Safety: Use union types for flexible input handling
- Error Handling: Always check
$result->validbefore accessing data
🤝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Ensure all tests pass
- Submit a pull request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Indonesian government for the NIK and KK number format specifications
- PHP community for the excellent 8.4 features
- All contributors who helped optimize this package
Built with ❤️ and optimized for PHP 8.4+
All versions of number-validator with dependencies
PHP Build Version
Package Version
Requires
php Version
^8.4
The package turahe/number-validator contains the following files
Loading the files please wait ....