README

Paket utilitas Laravel berisi:

Blade directive @currency
Helper global format_rupiah()
Helper Indonesia untuk format tanggal, angka, dan utilitas lainnya
Service ExcelExportService untuk export Excel
Service BniBillingEncryptor untuk enkripsi/dekripsi BNI e-Collection
Google Cloud Storage — Laravel filesystem adapter untuk GCS (Storage::disk('gcs'))

Kompatibel dengan Laravel 10, 11, 12, dan 13.

Instalasi

composer require ojiepermana/laravel

Atau jika lokal:

composer config repositories.ojie path ./path/ke/folder/laravel
composer require ojiepermana/laravel:*

Penggunaan

Blade Directive

@currency(1500000)

Output:

Rp 1.500.000

Helper

format_rupiah(250000); // Rp 250.000

Export Excel

ExcelExportService::exportArray('laporan.xlsx', $data, $headers);

Helper Indonesia

Library ini menyediakan berbagai helper untuk format tanggal, angka, dan utilitas Indonesia lainnya.

Format Tanggal Indonesia

// Format default (tanggal bulan tahun)
tanggal_indo('2026-02-07'); 
// Output: 07 Februari 2026

// Dengan nama hari
tanggal_indo('2026-02-07', 'mf', true); 
// Output: Jumat, 07 Februari 2026

// Dengan waktu
tanggal_indo('2026-02-07 14:30:00', 'mf', false, true); 
// Output: 07 Februari 2026 : 14:30

// Format bulan pendek
tanggal_indo('2026-02-07', 'mh'); 
// Output: 07 Feb 2026

// Menggunakan class
use OjiePermana\Laravel\Helpers\IndonesiaHelper;
IndonesiaHelper::tanggal('2026-02-07', 'mf', true, true);

Nama Bulan Indonesia

// Bulan penuh
bulan_indo('mf', 2); // Februari

// Bulan pendek
bulan_indo('mh', 2); // Feb

Format Mata Uang

// Format rupiah
format_uang(1500000); 
// Output: Rp 1.500.000

// Tanpa lambang
format_uang(1500000, 'ya', false); 
// Output: 1.500.000

// Sembunyikan nilai
format_uang(1500000, 'tidak'); 
// Output: rahasia

Angka Romawi

angka_romawi(12); // XII
angka_romawi(2026); // MMXXVI

Terbilang

terbilang(1500000); 
// Output: satu juta lima ratus ribu

terbilang(2026); 
// Output: dua ribu dua puluh enam

Nama Hari

nama_hari('2026-02-07'); // Jumat
nama_hari('2026-01-01'); // Kamis

Bulan dan Tahun

bulan_tahun_indo('2026-02-07'); // Februari 2026

Perhitungan Tanggal

// Jumlah hari antara dua tanggal
jumlah_hari('2026-02-01', '2026-02-28'); // 27

// Jumlah bulan antara dua tanggal
jumlah_bulan('2026-01-01', '2026-06-30'); // 5

// Minggu keberapa dalam bulan
minggu_ke_bulan('2026-02-07'); // pertama

// Hari terakhir bulan
hari_terakhir_bulan('2026-02-07'); // 2026-02-28

// Hari pertama minggu (Senin)
hari_pertama_minggu('2026-02-07'); // 2026-02-02

// Hari terakhir minggu (Minggu)
hari_terakhir_minggu('2026-02-07'); // 2026-02-08

Menggunakan Class Helper

Semua fungsi di atas juga tersedia melalui class IndonesiaHelper:

use OjiePermana\Laravel\Helpers\IndonesiaHelper;

// Contoh penggunaan
IndonesiaHelper::tanggal('2026-02-07', 'mf', true, true);
IndonesiaHelper::uang(1500000);
IndonesiaHelper::terbilang(2026);
IndonesiaHelper::romawi(12);
IndonesiaHelper::nameday('2026-02-07');
IndonesiaHelper::jumlahHari2Tanggal('2026-02-01', '2026-02-28');
// dll.

BNI e-Collection — API

Service untuk integrasi BNI e-Collection API (create, update, inquiry billing Virtual Account).

Konfigurasi billing dan payment sekarang disatukan di config/bni.php:

Billing: bni.billing.*
Payment H2H: bni.payment.*

use OjiePermana\Laravel\Facades\BNI;

BNI::create(trxId: 'INV-001', trxAmount: '150000', billingType: 'c', customerName: 'Budi');
BNI::update(trxId: 'INV-001', trxAmount: '200000', customerName: 'Budi');
BNI::show('INV-001');

Atau manual tanpa Facade:

use OjiePermana\Laravel\Bank\BNI\Billing\BniBillingClient;

$bni = new BniBillingClient(
    clientId:  env('BNI_BILLING_CLIENT_ID'),
    secretKey: env('BNI_BILLING_SECRET_KEY'),
    prefix:    env('BNI_BILLING_PREFIX'),
    url:       env('BNI_BILLING_URL'),
);

Contoh .env minimum:

# Billing (e-Collection)
BNI_BILLING_CLIENT_ID=001
BNI_BILLING_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
BNI_BILLING_PREFIX=8
BNI_BILLING_URL=https://apibeta.bni-ecollection.com/

BNI_PAYMENT_OAUTH_URL=https://<host-payment>/api/oauth/token
BNI_PAYMENT_CLIENT_ID=your-client-id
BNI_PAYMENT_CLIENT_SECRET=your-client-secret
BNI_PAYMENT_API_KEY=your-api-key
BNI_PAYMENT_API_SECRET=your-api-secret
BNI_PAYMENT_CLIENT_NAME=your-client-name
BNI_PAYMENT_CLIENT_ID_PREFIX=IDBNI

Dokumentasi lengkap: Docs/Bank/BNI/README.md

BNI e-Collection — Enkripsi

Service untuk enkripsi dan dekripsi data transaksi BNI Virtual Account secara manual.

use OjiePermana\Laravel\Bank\BNI\Billing\BniBillingEncryptor;

$hashed = BniBillingEncryptor::encryptPayload($data, $client_id, $secret_key);
$result = BniBillingEncryptor::decryptPayload($hashed_string, $client_id, $secret_key);

Dokumentasi lengkap: Docs/Bank/BNI/README.md

Google Cloud Storage

Laravel filesystem adapter untuk Google Cloud Storage. Terintegrasi penuh dengan Storage::disk() standar Laravel.

use Illuminate\Support\Facades\Storage;
use OjiePermana\Laravel\Facades\GCS;

// Upload file
GCS::putFile('uploads', $request->file('dokumen'));

// URL publik
$url = Storage::disk('gcs')->url('images/foto.jpg');

// Baca, hapus, copy, move
$data = Storage::disk('gcs')->get('documents/laporan.pdf');
Storage::disk('gcs')->delete('temp/file.txt');
Storage::disk('gcs')->copy('original.jpg', 'backup/original.jpg');

// Signed URL untuk file private
$signedUrl = Storage::disk('gcs-private')->getAdapter()->signedUrl('contracts/kontrak.pdf', 3600);

Konfigurasi di config/filesystems.php:

'gcs' => [
    'driver'      => 'gcs',
    'project_id'  => env('GCS_PROJECT_ID'),
    'key_file'    => env('GCS_KEY_FILE'),
    'bucket'      => env('GCS_BUCKET'),
    'path_prefix' => env('GCS_PATH_PREFIX', ''),
    'visibility'  => 'public',
],

Dokumentasi lengkap: Docs/Storage/Google/README.md

ojiepermana / laravel

Maintainers

Package info

Statistics

Security