Setup Laravel & Helper

Setup Laravel dan Helper Functions

Di lesson ini, kita akan menyiapkan "meja kerja" - menginstall Laravel dan membuat fungsi-fungsi pembantu yang akan dipakai di seluruh project.

Step 1: Buat Project Laravel Baru

Langkah 1: Pindah ke folder htdocs (tempat Laravel diinstall)

# Untuk XAMPP Windows (biasanya di C:\xampp\htdocs)
cd C:\xampp\htdocs

# Untuk Laragon Windows (biasanya di C:\laragon\www)
cd C:\laragon\www

# Untuk Mac (biasanya di /Applications/XAMPP/htdocs)
cd /Applications/XAMPP/htdocs

Langkah 2: Buat project Laravel baru

# Jalankan command ini (tunggu 2-5 menit)
composer create-project laravel/laravel simrs-app

Langkah 3: Masuk ke folder project dan jalankan server

# Masuk ke folder project
cd simrs-app

# Jalankan server development Laravel
php artisan serve

Step 2: Buat Database MySQL

Langkah membuat database:

1. Di sidebar kiri phpMyAdmin, klik "New" atau "Baru"
2. Di kolom "Database name", ketik: simrs_db
3. Di dropdown "Collation", pilih: utf8mb4_unicode_ci
4. Klik tombol "Create" atau "Buat"

Step 3: Konfigurasi File .env

Cari bagian yang dimulai dengan DB_ dan ubah menjadi:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=simrs_db
DB_USERNAME=root
DB_PASSWORD=

Step 4: Test Koneksi Database

# Pastikan Anda di folder project
cd C:\xampp\htdocs\simrs-app

# Jalankan migration untuk test koneksi
php artisan migrate

Akan muncul pertanyaan:

WARN  The database 'simrs_db' does not exist on the 'mysql' connection.
Would you like to create it? (yes/no) [yes]

Ketik yes dan tekan Enter.

Step 5: Buat Folder dan File Helper

<?php
// =============================================
// File: app/Helpers/AppHelper.php
// Fungsi: Helper functions untuk format data
// =============================================

/**
 * Format angka ke Rupiah Indonesia
 * 
 * Contoh penggunaan:
 * format_rupiah(150000) --> "Rp 150.000"
 * format_rupiah(1500000) --> "Rp 1.500.000"
 */
if (!function_exists('format_rupiah')) {
    function format_rupiah($angka)
    {
        if ($angka === null) {
            return "Rp 0";
        }
        return "Rp " . number_format($angka, 0, ',', '.');
    }
}

/**
 * Format tanggal ke format Indonesia
 * 
 * Contoh penggunaan:
 * format_date_indo('2023-10-20') --> "20 Oktober 2023"
 * format_date_indo(now()) --> "6 Desember 2024"
 */
if (!function_exists('format_date_indo')) {
    function format_date_indo($date)
    {
        if ($date === null) {
            return "-";
        }
        return \Carbon\Carbon::parse($date)->locale('id')->isoFormat('D MMMM Y');
    }
}

/**
 * Format datetime ke format Indonesia dengan jam
 * 
 * Contoh penggunaan:
 * format_datetime_indo('2023-10-20 14:30:00') --> "20 Oktober 2023, 14:30"
 */
if (!function_exists('format_datetime_indo')) {
    function format_datetime_indo($datetime)
    {
        if ($datetime === null) {
            return "-";
        }
        return \Carbon\Carbon::parse($datetime)->locale('id')->isoFormat('D MMMM Y, HH:mm');
    }
}

/**
 * Generate kode transaksi unik
 * 
 * Contoh penggunaan:
 * generate_kode('INV') --> "INV-20231020-5678"
 * generate_kode('REG') --> "REG-20231020-1234"
 */
if (!function_exists('generate_kode')) {
    function generate_kode($prefix = 'TRX')
    {
        return $prefix . '-' . date('Ymd') . '-' . rand(1000, 9999);
    }
}

/**
 * Hitung umur dari tanggal lahir
 * 
 * Contoh penggunaan:
 * hitung_umur('1990-05-15') --> "33 tahun"
 */
if (!function_exists('hitung_umur')) {
    function hitung_umur($tanggal_lahir)
    {
        if ($tanggal_lahir === null) {
            return "-";
        }
        return \Carbon\Carbon::parse($tanggal_lahir)->age . ' tahun';
    }
}

Step 6: Daftarkan Helper di Composer

Cari bagian ini di composer.json:

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Database\\Factories\\": "database/factories/",
        "Database\\Seeders\\": "database/seeders/"
    }
},

Ubah menjadi (tambahkan bagian files):

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Database\\Factories\\": "database/factories/",
        "Database\\Seeders\\": "database/seeders/"
    },
    "files": [
        "app/Helpers/AppHelper.php"
    ]
},

Step 7: Update Autoload Composer

# Regenerate autoload files
composer dump-autoload

Full Source Code

Checkpoint - Test Manual

Ringkasan