Di Artikel ini Anda akan mempelajari cara install Laravel 12 secara lengkap mulai dari persiapan lingkungan, instalasi menggunakan Composer, instalasi berdasarkan sistem operasi (Windows, Linux, Mac), konfigurasi environment, verifikasi instalasi, hingga troubleshooting error yang sering muncul.

Panduan ini dirancang agar dapat digunakan oleh pemula maupun developer berpengalaman yang membutuhkan instruksi teknis yang jelas dan terstruktur.

---

Daftar Isi

1. Persyaratan Sistem Laravel 12
2. Instalasi Laravel 12 (Semua Sistem Operasi)
3. Cara Instal Laravel 12 di Windows (XAMPP/Laragon)
4. Cara Instal Laravel 12 di Linux (Ubuntu/Debian)
5. Cara Instal Laravel 12 di MacOS
6. Konfigurasi Environment (.env)
7. Menjalankan Aplikasi Laravel 12
8. Verifikasi Instalasi Laravel
9. Instalasi Laravel 12 Menggunakan Laravel Sail (Docker)
10. Troubleshooting & Error Umum
11. FAQ Laravel 12
12. Penutup

---

1. Persyaratan Sistem Laravel 12

Laravel 12 membutuhkan spesifikasi minimal berikut:

Komponen	Versi Minimal	Catatan
PHP	8.1	Disarankan menggunakan PHP 8.2
Composer	2.x	Wajib
MySQL	5.7+ / MariaDB 10.3+	InnoDB
Ekstensi PHP	openssl, pdo, pdo_mysql, mbstring, tokenizer, xml, ctype, bcmath	Wajib
Node.js	18+	Untuk Vite & asset bundling

Cek versi PHP dan ekstensi:

php -v
php -m | grep -E 'pdo|mbstring|openssl|xml|ctype|bcmath'

---

2. Instalasi Laravel 12 (Metode Universal – Composer)

Ini adalah metode utama instalasi Laravel 12 untuk semua platform.

1) Buat proyek Laravel 12

composer create-project laravel/laravel:^12 my-laravel-app

2) Masuk ke folder proyek

cd my-laravel-app

3) Copy file environment

cp .env.example .env

4) Generate key aplikasi

php artisan key:generate

5) Jalankan server lokal

php artisan serve

Akses:
http://localhost:8000

---

3. Cara Instal Laravel 12 di Windows

Menggunakan Laragon (Direkomendasikan)

1) Instal Laragon

Unduh Laragon dan jalankan installer.

2) Buka terminal Laragon

Klik: Terminal → Laragon Terminal

3) Instal Laravel 12

composer create-project laravel/laravel:^12 my-app

4) Jalankan aplikasi

Klik Start All → Browse → otomatis membuka project.

---

Menggunakan XAMPP

1) Pastikan PHP minimal 8.1

Letakkan Laravel di:
C:/xampp/htdocs/

2) Buat project baru

composer create-project laravel/laravel:^12 C:/xampp/htdocs/my-app

3) Jalankan server

php artisan serve

---

4. Cara Instal Laravel 12 di Linux (Ubuntu/Debian)

1) Install PHP & ekstensi

sudo apt update
sudo apt install php php-mbstring php-xml php-bcmath php-curl php-zip php-mysql unzip curl -y

2) Install Composer

sudo apt install composer

3) Buat project Laravel 12

composer create-project laravel/laravel:^12 my-app

4) Permission storage & bootstrap

sudo chmod -R 775 storage bootstrap/cache
sudo chown -R $USER:www-data storage bootstrap/cache

---

5. Cara Instal Laravel 12 di MacOS

1) Instal PHP dan Composer via Homebrew

brew install php
brew install composer

2) Buat project Laravel

composer create-project laravel/laravel:^12 my-app

---

6. Konfigurasi Environment (.env)

Buka file .env lalu sesuaikan:

APP_NAME="Laravel 12"
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost:8000

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

Migrasi database:

php artisan migrate

---

7. Menjalankan Aplikasi Laravel 12

Jalankan server:

php artisan serve

Jalankan Vite jika Anda menggunakan frontend:

npm install
npm run dev

---

8. Verifikasi Instalasi Laravel 12

Cek versi Laravel:

php artisan --version

Jika tampil:

Laravel Framework 12.x.x

Maka instalasi berhasil.

---

9. Instalasi Laravel 12 Menggunakan Laravel Sail (Docker)

Laravel Sail memungkinkan menjalankan Laravel menggunakan Docker container.

1) Tambahkan Sail

composer require laravel/sail --dev

2) Install Sail

php artisan sail:install --with=mysql,redis,mailhog

3) Jalankan container

./vendor/bin/sail up -d

4) Jalankan migrasi

./vendor/bin/sail artisan migrate

---

10. Penyelesaian Masalah Umum

1) Memory limit error di Composer

PHP Fatal error: Allowed memory size exhausted

Solusi:

COMPOSER_MEMORY_LIMIT=-1 composer create-project laravel/laravel:^12 my-app

2) ext-mbstring missing

Instal ekstensi:

sudo apt install php-mbstring
sudo service apache2 restart

3) Error APP_KEY belum digenerate

php artisan key:generate

4) Permission error Linux

sudo chmod -R 775 storage bootstrap/cache

5) Port 8000 sedang dipakai

php artisan serve --port=8010

---

11. FAQ Laravel 12

1. Apa versi PHP minimal untuk Laravel 12?

Minimal PHP 8.1, disarankan 8.2.

2. Apakah bisa instal Laravel 12 tanpa Composer?

Secara praktik tidak direkomendasikan. Composer adalah dependency manager utama Laravel.

3. Bagaimana instal Laravel 12 di cPanel?

Gunakan fitur Terminal di cPanel:

composer create-project laravel/laravel:^12 .

4. Mengapa muncul error “No application encryption key has been specified”?

Jalankan php artisan key:generate.

5. Apakah Laravel 12 bisa dijalankan di Shared Hosting?

Bisa, selama PHP ≥ 8.1 dan Composer tersedia.

---

12. Penutup

Dengan mengikuti langkah-langkah di atas, Anda sudah memahami cara install Laravel 12 dengan benar di berbagai lingkungan—Windows, Linux, MacOS, Composer standar, maupun Docker via Laravel Sail. Struktur ini memberikan fondasi kuat untuk membangun aplikasi modern berbasis Laravel, Anda juga direkomendasikan membaca dokumenasi lengkap laravel.

Jika Anda membutuhkan dukungan profesional untuk pengembangan website, aplikasi, atau implementasi Laravel, Anda dapat memanfaatkan layanan dari Arrazy Inovasi sebagai mitra teknis Anda.

Untuk melanjutkan belajar dan memperdalam dasar-dasar Laravel 12, Anda dapat membaca panduan berikutnya seperti cara menggunakan Artisan Command dan membuat Custom Command di Laravel 12, kemudian memahami konsep otorisasi melalui Policy dan Gate di Laravel 12. Jika Anda ingin menguasai manajemen database, pastikan juga mempelajari cara kerja Migration di Laravel serta memahami struktur dasar routing melalui panduan lengkap Route Laravel.

---