Download the PHP package d1msky/nusantara-shipping without Composer
On this page you can find all versions of the php package d1msky/nusantara-shipping. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download d1msky/nusantara-shipping
More information about d1msky/nusantara-shipping
Files in d1msky/nusantara-shipping
Package nusantara-shipping
Short Description Indonesia region data (Kepmendagri 2025) for Laravel — shipping address formatting, postal code lookup, fuzzy search, dual-mode storage (file/database). Usable worldwide in Laravel apps.
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 nusantara-shipping
Nusantara — Indonesia Region Data for Laravel
Official Indonesian administrative region data (Kepmendagri 2025) for Laravel — with shipping address formatting, postal code lookup, fuzzy search, and dual-mode storage (file or database). Built for Laravel apps anywhere in the world that need to handle Indonesian addresses (e.g. e‑commerce, logistics, forms).
Why this package?
| Feature | Nusantara | Others |
|---|---|---|
| Data | Kepmendagri 2025 (updateable via command) | Often 2018–2022 |
| Storage | File (zero DB) or Database | Usually DB-only or file-only |
| Shipping | Address formatter, postal lookup, coordinates | Rare or basic |
| Search | Fuzzy + Indonesian aliases (Jkt, Jaksel, SBY, …) | Exact or simple like |
| DX | PHP 8.1+ enums, typed API, caching | Varies |
Use it for: dropdowns (provinces → regencies → districts → villages), address validation, shipping labels, postal code checks, and search that understands “Jaksel”, “Surabaya”, “Jogja”, etc.
Requirements
- PHP 8.1+
- Laravel 10, 11, or 12
- illuminate/support & illuminate/database (no extra deps)
Installation
Publish config (optional):
Or manually:
For database mode (optional):
Quick start
Configuration
Publish and edit config/nusantara.php:
| Option | Default | Description |
|---|---|---|
driver |
file |
file (no DB) or database |
table_prefix |
nusantara_ |
Table prefix in database mode |
cache_ttl |
86400 |
Cache TTL (seconds); 0 = no cache |
cache_store |
null |
Cache store (null = default) |
data_path |
package data/ |
Path to PHP data files (file driver) |
search.fuzzy_threshold |
70 |
Min similarity (0–100) for fuzzy match |
search.max_results |
20 |
Max search results |
aliases |
[] |
Custom alias → region name for search |
shipping_styles |
[] |
Custom courier formats |
Env example:
Database mode
- Set
NUSANTARA_DRIVER=database. -
Run migrations:
- Seed from package data files:
Tables: nusantara_provinces, nusantara_regencies, nusantara_districts, nusantara_villages.
Artisan commands
| Command | Description |
|---|---|
nusantara:install |
Publish config; optional --migrate and --seed |
nusantara:seed |
Seed DB from data files (--only=provinces|regencies|districts|villages) |
nusantara:update-data |
Show data source info; use --source=<path_or_url> to fetch and transform |
nusantara:stats |
Print counts (provinces, regencies, districts, villages, postal codes) |
nusantara:clear-cache |
Clear Nusantara cache |
Extending
Custom search aliases (config/nusantara.php):
Custom shipping style:
Then: Nusantara::shippingAddress($code, style: 'my_courier').
Data source and updates
Region data follows Kepmendagri (Indonesian Ministry of Home Affairs). The package ships with sample data so it works out of the box. For full or up-to-date datasets, use the nusantara:update-data command.
Command
- Without
--source: prints usage and recommended sources (no files changed). - With
--source: fetches or reads JSON from the given path/URL, converts it to the PHP format used by the package, and writesprovinces.php,regencies.php,districts.php, andvillages.phpinto the packagedata/folder (orconfig('nusantara.data_path')if set).
Input: path or URL
| Type | Example | Description |
|---|---|---|
| Local folder | --source=/path/to/data |
Folder must contain at least provinces.json. Optional: regencies.json, districts.json, villages.json. |
| Base URL | --source=https://example.com/data |
Command will request {url}/provinces.json, {url}/regencies.json, etc. Each must return a JSON array. |
For a local folder, the path must be absolute or relative to the current working directory. For a URL, use a base URL that serves the JSON files directly (e.g. raw GitHub or a CDN).
Required and optional files
| File | Required | Description |
|---|---|---|
provinces.json |
Yes | Array of province objects. |
regencies.json |
No | Array of regency/kabupaten/kota objects. |
districts.json |
No | Array of district/kecamatan objects. |
villages.json |
No | Array of village/kelurahan/desa objects. |
If a file is missing, that level is skipped; existing PHP data for that level is not overwritten.
Expected JSON structure
Each file must be a JSON array of objects. The command normalizes common field names:
- Provinces:
code/id/kode,name/nama; optional:latitude/lat,longitude/lng/lon. - Regencies:
code/id/kode,name/nama,province_code/provinceCode/kode_provinsi/province_id(or derived from code); optional:latitude,longitude. - Districts:
code/id/kode,name/nama,regency_code/regencyCode/kode_kabupaten(or derived from code); optional:latitude,longitude. - Villages:
code/id/kode,name/nama,district_code/districtCode/kode_kecamatan(or derived from code); optional:postal_code/postalCode/kode_pos/zip.
Codes can be dotted (e.g. 32.73) or plain (e.g. 3273); the command normalizes to dotted format where applicable.
Example: URL (raw GitHub)
This URL serves provinces.json, regencies.json, districts.json, and villages.json directly.
Example: local folder
- Clone a repo that contains JSON (e.g. in a
dataordata/list_of_areafolder). - Run:
The folder must contain at least provinces.json.
After updating data
- File driver (
NUSANTARA_DRIVER=file): Data is read from the updated PHP files; no further step. - Database driver (
NUSANTARA_DRIVER=database): Run the seeder to fill the database from the updated files:
Then check counts:
Recommended public sources
- yusufsyaifudin/wilayah-indonesia — JSON in
data/list_of_area/(provinces, regencies, districts, villages). - cahyadsn/wilayah — Kepmendagri; provides SQL; for JSON you need to export or use a repo that exposes JSON.
- hanifabd/wilayah-indonesia-area — data in other formats (e.g. zip); use a source that exposes
.jsonfiles if you want to use--source=<url>directly.
Testing
To generate a coverage report (requires PCOV or Xdebug):
Contributing
Contributions are welcome. Please open an issue or PR on GitHub.
License
MIT. See LICENSE.
All versions of nusantara-shipping with dependencies
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/database Version ^10.0|^11.0|^12.0