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.