Laravel

Panduan Lengkap Instalasi dan Memulai Proyek Laravel 11

15 Feb 2025 7 menit baca

"Tutorial langkah demi langkah instalasi Laravel 11 dan setup database. Panduan praktis untuk web developer pemula memulai proyek PHP modern."

Panduan Lengkap Instalasi dan Memulai Proyek Laravel 11

Laravel 11 telah resmi dirilis dan membawa angin segar bagi komunitas web developer di seluruh dunia. Dikenal sebagai salah satu framework PHP paling populer, modern, dan elegan, rilis versi 11 ini hadir dengan filosofi desain yang jauh lebih ramping (streamlined structure), konfigurasi minimalis, serta peningkatan performa yang signifikan.

Jika Anda baru memulai belajar pemrograman web modern atau ingin meningkatkan keahlian dari versi Laravel terdahulu, artikel ini dirancang khusus sebagai panduan komprehensif dari nol. Kita akan membahas tuntas mulai dari persyaratan sistem, instalasi, memahami perubahan arsitektur folder baru, hingga menjalankan aplikasi pertama Anda dengan lancar.

Daftar Pembahasan

Mengenal Laravel 11 dan Perubahan Utamanya

Laravel 11 tidak hanya sekadar pembaruan versi biasa. Tim inti Laravel di bawah arahan Taylor Otwell melakukan refactoring besar-besaran untuk mengurangi boilerplate code yang selama ini ada di proyek Laravel standar. Beberapa perubahan utama yang langsung Anda rasakan meliputi:

  • Struktur Folder Minimalis: Jumlah folder dan file di dalam direktori app/ berkurang drastis. Middleware bawaan, Exception Handler, dan Console Kernel kini tidak lagi memenuhi struktur folder secara default.
  • Konfigurasi Terpusat di bootstrap/app.php: Pengaturan routing, middleware web/api, dan penanganan exception sekarang dikonfigurasi secara deklaratif di dalam satu berkas terpadu yaitu bootstrap/app.php.
  • SQLite sebagai Default Database: Untuk mempermudah proses prototyping dan pengujian cepat bagi pemula, Laravel 11 menggunakan SQLite secara bawaan sehingga Anda tidak wajib langsung menyalakan server MySQL untuk sekadar mencoba aplikasi.
  • Model Casts Berbasis Method: Pendekatan baru penulisan casting atribut model menggunakan method casts() yang mendukung array dan enum native PHP secara lebih ekspresif.

Prasyarat Sistem yang Dibutuhkan

Sebelum memulai instalasi, pastikan lingkungan kerja (development environment) di komputer Anda telah memenuhi persyaratan teknis minimum berikut:

  • PHP 8.2 atau 8.3: Laravel 11 mewajibkan versi PHP minimal 8.2.
  • Ekstensi PHP Wajib: cURL, OpenSSL, Mbstring, PDO, Tokenizer, XML, Ctype, dan JSON (biasanya sudah aktif di Laragon, XAMPP, atau Homebrew).
  • Composer: Dependency manager resmi untuk ekosistem PHP versi 2.2 ke atas.
  • Node.js & NPM: Diperlukan untuk kompilasi aset frontend menggunakan Vite.

Langkah 1: Mempersiapkan PHP dan Composer

Langkah awal adalah memastikan bahwa PHP dan Composer telah terpasang dengan benar di sistem Anda. Buka terminal atau PowerShell, lalu ketik perintah berikut:

# Periksa versi PHP
php -v

# Periksa versi Composer
composer -V

Pastikan versi PHP menunjukkan minimal PHP 8.2.x. Jika Anda pengguna Windows, kami sangat menyarankan menggunakan stack Laragon karena telah mendukung pergantian versi PHP dan virtual host otomatis secara praktis.

Langkah 2: Proses Instalasi Proyek Laravel 11

Terdapat dua cara utama untuk membuat proyek Laravel 11: menggunakan Composer Create-Project atau menggunakan Laravel Installer. Kedua metode ini menghasilkan proyek yang sama persis.

Opsi A: Menggunakan Composer Create-Project (Direkomendasikan Pemula)

Jalankan perintah berikut di direktori web server Anda (misalnya di folder C:\laragon\www atau ~/Projects):

composer create-project laravel/laravel:^11.0 belajarlaravel11

Composer akan secara otomatis mengunduh skeleton Laravel 11 beserta seluruh library dependensi yang dibutuhkan. Proses ini membutuhkan waktu 1-3 menit tergantung kecepatan koneksi internet Anda.

Opsi B: Menggunakan Laravel Installer Global

Jika Anda sudah memasang Laravel Installer secara global, Anda cukup menjalankan perintah:

laravel new belajarlaravel11

CLI installer interaktif akan menanyakan beberapa opsi konfigurasi seperti starter kit, database engine, dan test framework yang ingin Anda gunakan.

Langkah 3: Memahami Struktur Folder Baru yang Lebih Ramping

Setelah instalasi selesai, masuk ke direktori proyek dan buka menggunakan kode editor favorit Anda seperti Visual Studio Code:

cd belajarlaravel11
code .

Berikut adalah perbandingan ringkas struktur baru Laravel 11:

belajarlaravel11/
├── app/
│   ├── Http/
│   │   └── Controllers/
│   │       └── Controller.php
│   └── Models/
│       └── User.php
├── bootstrap/
│   ├── app.php          # Pusat konfigurasi routing, middleware & exception
│   └── providers.php
├── config/              # Berkas konfigurasi kini jauh lebih ramping
├── database/
│   ├── factories/
│   ├── migrations/
│   └── seeders/
├── public/
├── resources/
│   ├── css/
│   ├── js/
│   └── views/
│       └── welcome.blade.php
├── routes/
│   ├── console.php
│   └── web.php
└── .env

Perhatikan bahwa folder app/Http/Middleware dan app/Console tidak lagi dibuat secara default. Anda tetap dapat membuatnya kapan saja jika memang proyek Anda membutuhkan custom middleware menggunakan perintah Artisan.

Langkah 4: Konfigurasi File Environment (.env) dan Database

Buka berkas .env pada root proyek. Berkas ini menyimpan konfigurasi kredensial sistem, mode debug, dan koneksi basis data.

Secara default di Laravel 11, konfigurasi database menggunakan SQLite:

DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=

Jika Anda ingin beralih menggunakan server MySQL, ubah bagian tersebut menjadi seperti berikut:

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

Setelah database MySQL Anda dibuat di phpMyAdmin atau database GUI, jalankan migration bawaan untuk membuat tabel-tabel sistem:

php artisan migrate

Langkah 5: Menjalankan Server Development Lokal

Laravel dilengkapi server internal bawaan PHP yang sangat mudah dijalankan melalui perintah Artisan CLI:

php artisan serve

Terminal akan menampilkan pesan bahwa server telah aktif di https://127.0.0.1:8000. Buka peramban web (browser) Anda dan akses alamat tersebut. Anda akan disambut oleh landing page selamat datang khas Laravel 11 yang bersih dan modern.

Langkah 6: Membuat Routing dan Controller Pertama

Mari kita uji coba membuat fitur sederhana untuk memastikan alur kerja aplikasi berjalan dengan baik.

1. Membuat Controller Baru

Gunakan generator Artisan untuk membuat controller baru:

php artisan make:controller HomeController

Berkas baru akan tercipta di app/Http/Controllers/HomeController.php. Buka berkas tersebut dan tambahkan method index():

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HomeController extends Controller
{
    public function index()
    {
        $data = [
            'title' => 'Selamat Datang di Laravel 11',
            'author' => 'Aguzrybudy',
            'features' => [
                'Struktur direktori ultra ramping',
                'Konfigurasi terpusat di bootstrap/app.php',
                'Performa kencang bertenaga PHP 8.2+',
                'Dukungan Vite dan Tailwind CSS bawaan'
            ]
        ];

        return view('home', $data);
    }
}

2. Mendaftarkan Route di routes/web.php

Buka berkas routes/web.php dan hubungkan controller yang baru saja dibuat:

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\HomeController;

Route::get('/', [HomeController::class, 'index']);

3. Membuat View Blade di resources/views/home.blade.php

Buat berkas baru bernama resources/views/home.blade.php, lalu masukkan markup HTML sederhana berikut:

<!DOCTYPE html>
<html lang="id">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{{ $title }}</title>
    <style>
        body { font-family: system-ui, sans-serif; background: #0f172a; color: #f8fafc; padding: 40px; }
        .card { max-width: 600px; margin: 0 auto; background: #1e293b; padding: 30px; border-radius: 12px; border: 1px solid #334155; }
        h1 { color: #f43f5e; margin-top: 0; }
        ul { padding-left: 20px; line-height: 1.8; color: #94a3b8; }
        .footer { margin-top: 25px; font-size: 0.9rem; color: #64748b; border-top: 1px solid #334155; padding-top: 15px; }
    </style>
</head>
<body>
    <div class="card">
        <h1>{{ $title }}</h1>
        <p>Halo, selamat datang di proyek perdana Anda yang dibangun bersama {{ $author }}.</p>
        <h3>Keunggulan Laravel 11:</h3>
        <ul>
            @foreach($features as $feature)
                <li>{{ $feature }}</li>
            @endforeach
        </ul>
        <div class="footer">
            Dipublikasikan melalui Aguzrybudy.com • Tutorial Web Development Modern
        </div>
    </div>
</body>
</html>

Refresh peramban Anda di https://127.0.0.1:8000. Tampilan halaman kustom perdana Anda berhasil dibuat dan ter-render dengan sempurna!

Troubleshooting Masalah Umum Saat Instalasi

Berikut adalah beberapa kendala yang kerap dialami developer pemula beserta solusinya:

  • Error "Your Composer dependencies require a PHP version >= 8.2.0": Solusinya, perbarui instalasi PHP Anda ke versi 8.2 atau 8.3, dan pastikan path Environment Variable mengarah ke versi PHP terbaru.
  • Error "No application encryption key has been specified": Jalankan perintah php artisan key:generate di terminal untuk menghasilkan key enkripsi unik di file .env.
  • Error Permission Denied pada folder storage/ (di Linux/macOS): Berikan hak akses tulis pada folder penyimpanan dengan perintah chmod -R 775 storage bootstrap/cache.

Kesimpulan dan Langkah Berikutnya

Laravel 11 berhasil menyederhanakan arsitektur pengembangan web tanpa mengorbankan kekuatan dan skalabilitasnya. Dengan struktur direktori yang bersih, konfigurasi terpusat di bootstrap/app.php, dan ekosistem modern yang terintegrasi, Anda dapat membangun aplikasi web skala kecil hingga enterprise secara jauh lebih cepat dan terstruktur.

Pada tutorial berikutnya di seri Laravel ini, kita akan melangkah lebih jauh dengan membahas pembuatan RESTful API bertenaga Laravel 11 dan Laravel Sanctum untuk kebutuhan aplikasi seluler dan frontend modern.

Jika Anda memiliki pertanyaan seputar instalasi Laravel atau membutuhkan layanan konsultasi pembuatan website kustom, aplikasi web enterprise, dan software terintegrasi, jangan ragu untuk berdiskusi melalui menu kontak di Aguzrybudy.com.

Tags:
Laravel PHP

Bagikan Artikel

Bantu teman Anda menemukan solusi ini dengan membagikan artikel ini.

Mau website yang cepat & rapi?

Saya bantu struktur halaman, UI reusable, dan optimasi performa (CWV) supaya hasilnya kebaca.

Konsultasi Lihat layanan