fikar / phpnusantara
Helper PHP untuk kebutuhan aplikasi Indonesia
v1.2.0
2026-01-16 13:47 UTC
Requires
- php: >=7.4
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