Cara Install Laravel 11 untuk Pemula: Composer, Setup & Error Umum

laravel

Cara install Laravel 11 termasuk topik yang paling banyak dicari oleh developer PHP yang baru mulai belajar framework modern. Laravel 11, yang dirilis resmi pada Maret 2024, membawa beberapa perubahan struktural signifikan dibanding versi sebelumnya — terutama penghapusan beberapa file konfigurasi default dan penyederhanaan direktori app/. Panduan ini dirancang khusus untuk pemula yang baru pertama kali menginstal Laravel, maupun developer berpengalaman yang ingin memahami apa yang berubah dari Laravel 10 ke Laravel 11.

Sebelum mulai, pastikan Anda sudah memiliki PHP 8.2+ dan Composer terinstal. Jika belum, panduan ini juga mencakup langkah persiapan tersebut.

Kebutuhan Sistem untuk Laravel 11

Sebelum mulai, pastikan lingkungan development Anda memenuhi persyaratan minimum. Minimal PHP 8.1 ke atas diperlukan untuk menjalankan Laravel 11, disertai ekstensi PHP yang umum seperti OpenSSL, PDO, BCMath, JSON, dan mbstring. Sistem operasi bisa Linux, macOS, atau Windows (melalui WSL jika Anda menggunakan Windows). Selain itu, pastikan Anda memiliki akses internet stabil karena proses instalasi akan mengambil dependensi lewat Composer. Untuk referensi resmi tentang kebutuhan lingkungan, baca Dokumentasi Resmi Laravel 11.

Perangkat Lunak yang Diperlukan

Langkah berikutnya adalah memastikan Composer terinstal dengan benar, karena Laravel 11 dibangun di atas ekosistem PHP yang memanfaatkan Composer untuk manajemen dependensi. Selain itu, Node.js direkomendasikan jika Anda ingin mengelola assets front-end dengan alat seperti Vite.

Cara Install Laravel 11

1. Install PHP dan Ekstensi yang Diperlukan

Pastikan PHP telah terpasang pada sistem Anda. Anda bisa memeriksa versi PHP dengan perintah berikut:

php -v

Pastikan setidaknya PHP 8.1 terpasang. Jika belum, instal versi terbaru sesuai sistem operasi Anda dan pastikan ekstensi penting seperti OpenSSL, PDO, dan mbstring telah aktif di php.ini.

2. Install Composer

Composer adalah package manager PHP yang wajib ada sebelum menginstal Laravel. Download dan install dari getcomposer.org, lalu verifikasi dengan:

composer --version

3. Buat Project Laravel 11 via Composer

Setelah PHP dan Composer siap, jalankan perintah berikut untuk membuat project Laravel 11 baru:

composer create-project --prefer-dist laravel/laravel nama-project "11.*"

Atau, jika ingin menggunakan Laravel installer:

composer global require laravel/installer
laravel new nama-project

Proses ini akan mengunduh Laravel 11 beserta semua dependensinya. Tunggu hingga selesai.

4. Generate Application Key

Masuk ke direktori project dan generate APP_KEY:

cd nama-project
php artisan key:generate

Apa yang Berubah di Laravel 11 Dibanding Laravel 10

Laravel 11 membawa perubahan struktural yang cukup signifikan:

  • Direktori app/ lebih ramping — banyak file provider dan middleware yang sebelumnya ada di sini dipindahkan atau dihapus
  • Tidak ada app/Http/Kernel.php — middleware sekarang di-register via bootstrap/app.php
  • Service Provider lebih sedikit — hanya AppServiceProvider yang tersisa secara default
  • File konfigurasi banyak dihilangkan dari root — dipindahkan ke dalam framework itu sendiri
  • Dukungan SQLite bawaan — database default berubah ke SQLite untuk kemudahan development lokal

Setup Awal Setelah Instalasi

Konfigurasi File .env

Salin file contoh .env untuk membuat konfigurasi lingkungan lokal:

cp .env.example .env

Selanjutnya, sesuaikan pengaturan database dan aplikasi Anda. Contoh pengaturan untuk MySQL:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_database
DB_USERNAME=user_database
DB_PASSWORD=password_database

Jalankan Migrasi Database

php artisan migrate

Jalankan Development Server

Untuk melihat proyek Laravel 11 Anda secara langsung, jalankan development server:

php artisan serve

Server akan berjalan di http://localhost:8000. Buka di browser untuk memastikan instalasi berhasil.

Upgrade ke Laravel 12?

Jika Anda sudah menguasai Laravel 11 dan ingin bermigrasi ke Laravel 12, prosesnya relatif mulus karena kedua versi berbagi arsitektur yang sama. Baca panduan resmi di Laravel Upgrade Guide untuk langkah-langkah detail.

Troubleshooting: Error Umum Saat Install Laravel 11

Error: PHP version mismatch

Jika muncul error “Your PHP version does not satisfy the requirements”, pastikan PHP Anda minimal versi 8.1. Cek dengan php -v dan upgrade jika perlu.

Error: php artisan not found / command not found

Pastikan Anda sudah masuk ke direktori project (cd nama-project) sebelum menjalankan perintah php artisan.

Error: Composer require timeout

Jika proses composer create-project gagal karena timeout, coba tambahkan flag --prefer-dist atau gunakan mirror Packagist yang lebih dekat. Anda juga bisa meningkatkan timeout Composer:

composer config --global process-timeout 600

Error: 500 Internal Server Error setelah install

Kemungkinan penyebab: file .env belum di-copy dari .env.example, atau APP_KEY belum di-generate. Jalankan:

cp .env.example .env
php artisan key:generate

Error: Permission denied pada folder storage

Laravel membutuhkan akses tulis pada folder storage/ dan bootstrap/cache/. Jalankan:

chmod -R 775 storage bootstrap/cache

FAQ: Pertanyaan Umum tentang Instalasi Laravel 11

Apakah Laravel 11 bisa diinstall di Windows?

Bisa, tapi direkomendasikan menggunakan WSL (Windows Subsystem for Linux) untuk pengalaman development yang lebih mulus. Anda bisa menggunakan XAMPP atau Laragon sebagai alternatif jika tidak ingin menggunakan WSL.

Apa perbedaan composer create-project dan Laravel installer?

composer create-project mengunduh Laravel langsung dari Packagist — cocok untuk semua lingkungan. Laravel installer (laravel new) adalah shortcut resmi yang lebih cepat dan mendukung opsi starter kits. Keduanya menghasilkan project yang identik.

Bagaimana cara download Laravel 11 tanpa Composer?

Composer adalah cara resmi dan yang direkomendasikan. Jika tidak memiliki Composer, Anda bisa mengunduh zip source dari GitHub Laravel Releases, tapi Anda tetap perlu menjalankan composer install setelahnya untuk mengunduh dependensinya.

Berapa besar ukuran project Laravel 11 setelah install?

Project dasar Laravel 11 setelah composer install biasanya berukuran sekitar 30–50MB termasuk folder vendor/. Tanpa folder vendor (untuk deploy via Composer), ukurannya jauh lebih kecil.

Apakah Laravel 11 membutuhkan Node.js?

Node.js tidak wajib untuk menjalankan Laravel, tapi dibutuhkan jika Anda ingin menggunakan Vite untuk kompilasi asset frontend. Untuk aplikasi tanpa frontend build process, Node.js bisa diabaikan.

Ingin Langsung Membangun Aplikasi Web?

Memahami cara install Laravel 11 adalah langkah awal yang baik. Tapi membangun aplikasi web yang siap dipakai di production — lengkap dengan database, autentikasi, dashboard, dan deployment — membutuhkan pengalaman lebih. Jika Anda memiliki ide aplikasi atau website yang ingin diwujudkan, tim Arrazy Inovasi siap membantu membangun website profesional yang terstruktur dan scalable.

Konsultasikan kebutuhan Anda terlebih dahulu — tidak ada biaya untuk diskusi awal. Hubungi kami di sini.

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *