Download the PHP package turahe/master-data without Composer
On this page you can find all versions of the php package turahe/master-data. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package master-data
Laravel Master Data Package
A comprehensive Laravel package that provides master data for countries, provinces, cities, districts, villages, banks, currencies, and languages. Perfect for applications requiring geographical data, banking information, and internationalization support.
๐ Table of Contents
- Features
- Requirements
- Installation
- Configuration
- Usage
- Data Overview
- API Reference
- Testing
- Contributing
- License
โจ Features
- ๐ Geographical Data: Complete hierarchy of countries, provinces, cities, districts, and villages
- ๐ฆ Banking Information: Indonesian banks with codes, names, and company details
- ๐ฑ Currency Support: Global currencies with codes and symbols
- ๐ Language Support: International languages with ISO codes
- ๐ผ๏ธ Visual Assets: Country flags and city images included
- ๐ Easy Querying: Eloquent models with relationships and scopes
- โก Performance: Optimized database structure and caching
- ๐งช Comprehensive Testing: Full test coverage across multiple PHP/Laravel versions
๐ Requirements
- PHP: 8.2, 8.3, 8.4
- Laravel: 10.x, 11.x, 12.x
- Database: MySQL, PostgreSQL, SQLite (for testing)
๐ Installation
1. Install via Composer
2. Publish Assets and Migrations
3. Run Migrations
4. Seed the Database (Optional)
โ๏ธ Configuration
The package configuration is published to config/master.php
. You can customize table names and model classes:
๐ก Usage
Using Eloquent Models
Using the Facade
Relationships
Search and Filter
๐ Data Overview
This package provides comprehensive master data:
Data Type | Count | Description |
---|---|---|
Countries | 266 | Global countries with ISO codes |
Provinces | 4,526 | Administrative divisions worldwide |
Cities | 7,376 | Cities and municipalities |
Districts | 81,153 | Districts and sub-districts |
Villages | 1,570 | Villages and neighborhoods |
Banks | 256 | Indonesian banks with codes |
Currencies | 423 | Global currencies with symbols |
Languages | 266 | International languages with ISO codes |
Flags | 1,570 | Country flag images |
City Images | 7,376 | City landmark images |
๐ง API Reference
Models
Country
Province
City
Bank
Currency
Commands
๐งช Testing
This package is thoroughly tested against:
- PHP: 8.2, 8.3, 8.4
- Laravel: 10.x, 11.x, 12.x
Running Tests Locally
Test Matrix
The CI/CD pipeline excludes incompatible combinations:
- Laravel 12.x requires PHP 8.3+
- Laravel 10.x doesn't support PHP 8.4
๐ค Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
Development Setup
๐ License
This package is open-sourced software licensed under the MIT license.
๐ Acknowledgments
- Data sources for geographical information
- Laravel community for the excellent framework
- Contributors and maintainers
Made with โค๏ธ by Nur Wachid