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

Blog / Umum / Cara Membuat Project Laravel d...
Umum

Cara Membuat Project Laravel dengan Struktur Kode yang Rapi dan Mudah Dikembangkan

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
4 min read
8 views

Overview

Kode aplikasi yang tidak konsisten akan semakin sulit dipelihara saat fitur bertambah dan lebih banyak developer terlibat. Controller yang terlalu besar, validasi yang tersebar, dan query yang ditulis langsung di template membuat perubahan berisiko serta menyulitkan pengujian. Artikel ini menunjukkan pola awal untuk membangun proyek Laravel yang terstruktur tanpa membuat abstraksi berlebihan.

Tujuan utamanya adalah memisahkan tanggung jawab: route menentukan endpoint, controller mengoordinasikan request, Form Request memvalidasi input, model mengelola interaksi data, dan service/action digunakan bila proses bisnis memang cukup kompleks.

Prerequisites

  • PHP 8.2+ sebagai baseline Laravel 11/12.
  • Composer 2.x.
  • Proyek Laravel baru.
  • MySQL/MariaDB jika fitur membutuhkan penyimpanan data.
  • Git dan pemahaman dasar route, controller, model, migration, dan Blade.

Step-by-step tutorial

1. Buat aplikasi dan repository

composer create-project laravel/laravel katalog-produk
cd katalog-produk
git init
git add .
git commit -m "chore: initial Laravel project"

Sebelum commit, periksa .gitignore dan pastikan .env tidak ikut dilacak.

2. Gunakan konvensi penamaan yang konsisten

Gunakan nama model singular seperti Product, controller berakhiran Controller, nama route yang deskriptif, serta migration yang menjelaskan perubahan tabel. Hindari menamai komponen berdasarkan preferensi pribadi yang berbeda-beda di setiap modul. Konsistensi mempermudah code review dan onboarding developer baru.

3. Buat komponen yang diperlukan

php artisan make:model Product -m
php artisan make:controller ProductController --resource
php artisan make:request StoreProductRequest
php artisan make:request UpdateProductRequest

Contoh migration:

Schema::create('products', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('sku')->unique();
    $table->unsignedInteger('price');
    $table->boolean('is_active')->default(true);
    $table->timestamps();
});

Tipe price di atas hanya contoh untuk nominal integer. Pilih tipe yang sesuai dengan aturan bisnis, mata uang, dan kebutuhan perhitungan aplikasi.

4. Pusatkan validasi dengan Form Request

Contoh aturan pada StoreProductRequest:

public function authorize(): bool
{
    return true; // Ganti dengan aturan otorisasi sesuai aplikasi.
}

public function rules(): array
{
    return [
        'name' => ['required', 'string', 'max:255'],
        'sku' => ['required', 'string', 'max:100', 'unique:products,sku'],
        'price' => ['required', 'integer', 'min:0'],
        'is_active' => ['sometimes', 'boolean'],
    ];
}

authorize() bernilai true hanya bila proses ini memang boleh dilakukan oleh semua pengguna yang mencapai request tersebut. Untuk aplikasi nyata, gunakan Policy atau Gate jika hak akses bergantung pada peran atau kepemilikan data.

5. Buat controller yang fokus

public function index(): View
{
    $products = Product::query()->latest()->paginate(15);

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

public function store(StoreProductRequest $request): RedirectResponse
{
    Product::create($request->validated());

    return to_route('products.index')
        ->with('status', 'Produk berhasil dibuat.');
}

Tambahkan $fillable pada model dengan field yang memang boleh diisi:

protected $fillable = ['name', 'sku', 'price', 'is_active'];

Jangan menggunakan $request->all() untuk mass assignment karena input yang tidak diharapkan dapat ikut diproses.

6. Definisikan route dan view

Route::resource('products', ProductController::class)
    ->only(['index', 'store', 'create', 'show', 'edit', 'update', 'destroy']);

Pastikan setiap method yang didaftarkan tersedia dan tindakan update/delete dilindungi otorisasi. Simpan template di resources/views dan hindari menempatkan logika bisnis panjang dalam Blade.

7. Tambahkan test

php artisan make:test ProductManagementTest
php artisan test

Test setidaknya memeriksa validasi, otorisasi, penyimpanan, dan respons yang diharapkan. Gunakan database khusus testing agar pengujian tidak mengubah data development atau production.

Troubleshooting

  • Mass assignment exception: periksa $fillable atau $guarded, lalu gunakan data tervalidasi.
  • Route tidak ditemukan: jalankan php artisan route:list dan periksa nama route serta cache.
  • Tabel belum tersedia: pastikan koneksi benar dan migration sudah dijalankan.
  • Controller terlalu besar: pindahkan proses bisnis yang kompleks ke service/action dan lindungi refactor dengan test.
  • Pagination lambat: tinjau query, index database, eager loading, serta jumlah record yang diambil.

Best practices

Gunakan Form Request untuk validasi, Policy/Gate untuk otorisasi, transaksi untuk operasi multi-tabel yang harus atomik, dan pagination untuk daftar data. Buat service hanya ketika ada logika bisnis kompleks atau digunakan bersama. Hindari abstraksi yang tidak menambah kejelasan, dan jangan menampilkan exception internal kepada pengguna.

Related articles

Last tested

Tanggal penyusunan: 19 Oktober 2026. Contoh mengikuti pola umum Laravel modern tetapi belum dieksekusi pada proyek tertentu. Uji kode, namespace, dan test pada versi Laravel yang dipilih sebelum digunakan di production.

Bagikan artikel:

Artikel lainnya

Cari Artikel