Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Umum / Memahami Struktur Folder Larav...
Umum

Memahami Struktur Folder Laravel: Fungsi Routes, Controllers, Models, Middleware, dan Services

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
4 min read
9 views

Overview

Memahami struktur folder Laravel membantu developer menemukan tempat yang tepat untuk menaruh kode dan mengurangi ketergantungan yang tidak perlu. Jika route berisi query kompleks, controller mengurus terlalu banyak hal, dan template mengandung aturan bisnis, perubahan kecil bisa menjadi sulit diuji.

Artikel ini menjelaskan direktori utama Laravel dan alur request dari browser hingga database. Perlu diingat bahwa struktur dapat berbeda menurut versi Laravel dan starter kit yang digunakan.

Prerequisites

  • PHP 8.2+ sebagai baseline Laravel 11/12.
  • Proyek Laravel yang sudah dibuat.
  • Editor kode dan terminal.
  • Pemahaman dasar HTTP, route, controller, model, dan database.

Step-by-step tutorial

1. Kenali folder penting

Folder/file Tanggung jawab
app/Models Model Eloquent dan representasi data
app/Http/Controllers Mengoordinasikan request dan response
app/Http/Requests Validasi input dan otorisasi request
app/Http/Middleware Pemeriksaan atau pemrosesan request/response
app/Policies Aturan otorisasi resource
app/Services Konvensi tim untuk logika aplikasi; folder ini dapat dibuat sendiri
routes/web.php Route web dan middleware web
routes/api.php Route API jika routing API diaktifkan
resources/views Template Blade
resources/js, resources/css Asset frontend
database/migrations Perubahan skema database
database/seeders Data awal atau data referensi
tests Unit test dan feature test
config Konfigurasi aplikasi
storage Log, cache file, dan file runtime
public Document root yang dapat diakses web

Tidak semua file tersedia pada setiap skeleton. Gunakan Artisan atau setup resmi versi yang dipilih untuk membuat komponen yang belum ada.

2. Pahami alur request

Alur web sederhana dimulai ketika browser mengirim HTTP request. Laravel mencocokkan request dengan route, lalu middleware menjalankan pemeriksaan seperti autentikasi. Controller memproses request atau memanggil komponen aplikasi, model berinteraksi dengan database jika diperlukan, dan controller mengembalikan view, redirect, atau JSON. Response kemudian dikirim kembali ke browser.

3. Buat komponen dengan Artisan

php artisan make:controller ReportController
php artisan make:model Report -m
php artisan make:middleware EnsureAccountIsActive
php artisan make:request StoreReportRequest
php artisan make:policy ReportPolicy --model=Report

Gunakan php artisan list atau php artisan help untuk melihat opsi yang tersedia pada versi yang terpasang.

4. Contoh route dan controller

Route::get('/reports', [ReportController::class, 'index'])
    ->middleware('auth')
    ->name('reports.index');

Di controller:

public function index(): View
{
    $reports = Report::query()->latest()->paginate(20);

    return view('reports.index', compact('reports'));
}

View resources/views/reports/index.blade.php bertugas menampilkan daftar laporan. Hindari menjalankan query kompleks dan logika bisnis panjang di template karena akan sulit dipelihara dan diuji.

5. Buat service bila diperlukan

Laravel tidak mewajibkan folder Services. Tim dapat membuatnya ketika proses bisnis kompleks digunakan oleh beberapa controller atau jalur proses. Contoh:

namespace App\Services;

use App\Models\Order;
use Illuminate\Support\Facades\DB;

class OrderConfirmationService
{
    public function confirm(Order $order): void
    {
        DB::transaction(function () use ($order) {
            $order->update(['status' => 'confirmed']);
        });
    }
}

Kode ini hanya ilustrasi. Aplikasi nyata harus memvalidasi transisi status, otorisasi, pencatatan perubahan, dan aturan bisnis sebelum mengonfirmasi order.

6. Periksa route dan konfigurasi

php artisan route:list

Gunakan dokumentasi versi terkait untuk memeriksa cara mendaftarkan middleware dan konfigurasi routing. Pada Laravel modern, alias middleware umumnya dikonfigurasi melalui bootstrap/app.php, sedangkan aplikasi lama dapat menggunakan app/Http/Kernel.php.

Troubleshooting

  • Route API tidak ditemukan: pastikan routing API telah diaktifkan atau dikonfigurasi.
  • Namespace class salah: cocokkan namespace dengan lokasi file dan nama class.
  • View tidak ditemukan: periksa nama view, kapitalisasi, dan path di resources/views.
  • Middleware tidak dikenali: periksa cara pendaftaran middleware pada versi Laravel yang digunakan.
  • Logika tersebar: tentukan tanggung jawab tiap layer dan refactor secara bertahap dengan test.

Best practices

Jaga controller fokus pada koordinasi request. Gunakan Form Request untuk validasi yang sesuai dan Policy/Gate untuk otorisasi. Jangan menjalankan query langsung di template. Buat service/action ketika memberikan manfaat nyata, bukan semata-mata agar struktur folder terlihat kompleks. Dokumentasikan konvensi tim agar semua developer menerapkannya secara konsisten.

Related articles

Last tested

Tanggal penyusunan: 19 Oktober 2026. Artikel berdasarkan struktur umum Laravel modern; verifikasi terhadap skeleton proyek dan versi Laravel yang dipakai sebelum publikasi.

Bagikan artikel:

Artikel lainnya

Cari Artikel