fikar / phpnusantara
Helper PHP untuk kebutuhan aplikasi Indonesia
v1.2.0
2026-01-16 13:47 UTC
Requires
- php: >=7.4
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Library PHP sederhana berisi kumpulan helper berbahasa Indonesia untuk kebutuhan format Rupiah, Tanggal, Waktu, Terbilang, dan Waktu Relatif Dll.
📦 Instalasi
✅ Menggunakan Composer (Khusus Framework)
Library ini sudah mendukung instalasi melalui Composer, hanya untuk framework berbasis Composer seperti Laravel dan CodeIgniter 4.
composer require fikar/phpnusantara
📁 Lokasi Penempatan
Letakkan folder PHPNusantara ke dalam folder vendor/ pada project Anda.
📌 PHP Native
project-native/
├── vendor/
│ └── PHPNusantara/
│ └── src/
├── index.php
📌 Laravel
laravel-project/
├── vendor/
│ └── PHPNusantara/
│ └── src/
├── app/
├── public/
📌 CodeIgniter 4
ci4-project/
├── vendor/
│ └── PHPNusantara/
│ └── src/
├── app/
├── public/
📂 Struktur Folder
PHPNusantara/
├── src/
│ ├── App/
│ │ ├── Bulan.php
│ │ ├── Response.php
│ │ └── WaktuRelatif.php
│ │
│ ├── Bahasa/
│ │ └── StringHelper.php
│ │
│ ├── Formatter/
│ │ ├── Angka.php
│ │ ├── Persentase.php
│ │ ├── Rupiah.php
│ │ ├── Tanggal.php
│ │ ├── Terbilang.php
│ │ └── Waktu.php
│ │
│ └── Identity/
│ ├── Email.php
│ ├── Nik.php
│ └── Telepon.php
│
├── composer.json
└── README.md
🚀 Cara Penggunaan
1️⃣ PHP Native – Format Rupiah
<?php require __DIR__ . '/vendor/PHPNusantara/src/Formatter/Rupiah.php'; use PHPNusantara\Formatter\Rupiah; echo Rupiah::format(1500000); // Output: Rp 1.500.000
2️⃣ Laravel – Format Tanggal Indonesia
<?php require base_path('vendor/PHPNusantara/src/Formatter/Tanggal.php'); use PHPNusantara\Formatter\Tanggal; echo Tanggal::indo('2025-01-14'); // Output: 14 Januari 2025
3️⃣ CodeIgniter 4 – Terbilang Angka
<?php require ROOTPATH . 'vendor/PHPNusantara/src/Formatter/Terbilang.php'; use PHPNusantara\Formatter\Terbilang; echo Terbilang::buat(2500); // Output: dua ribu lima ratus
📖 Read Documentation
👉 https://github.com/InstaCodex/DocumentationPHPNusantara
✨ Catatan
- Library ini tidak bergantung Composer (manual include).
- Cocok untuk PHP Native, Laravel, maupun CodeIgniter.
📄 Lisensi
MIT License © InstaCodex