Setup Laravel Development Environment di Ubuntu

Laravel adalah framework PHP modern yang powerful dan banyak digunakan untuk membangun aplikasi web. Agar lingkungan development lebih mirip dengan environment produksi, kita bisa menggunakan Apache sebagai web server, PHP 8.3 dari PPA Ondřej, MariaDB sebagai database, serta SSL lokal menggunakan mkcert. Selain itu, kita juga akan menggunakan Visual Studio Code (VS Code) dengan beberapa extension khusus Laravel agar proses coding lebih produktif dan nyaman. Hasil akhirnya, kita akan memiliki domain lokal https://laravel.local dengan Laravel berjalan lengkap di Ubuntu.

1. Install PHP 8.3

Tambahkan repository Ondřej:

sudo add-apt-repository ppa:ondrej/php -y

Install PHP 8.3 beserta ekstensi penting untuk Laravel:

sudo apt install php8.3 php8.3-cli php8.3-common php8.3-mysql \
php8.3-xml php8.3-mbstring php8.3-bcmath php8.3-curl unzip curl -y

Cek versi PHP:

php -v

Install Composer untuk dependency manager PHP:

sudo apt install composer -y

2. Install Apache

Install Apache dan modul PHP:

sudo apt install apache2 libapache2-mod-php8.3 -y

Aktifkan modul penting dan restart Apache:

sudo a2enmod rewrite ssl
sudo systemctl restart apache2

3. Install MariaDB

MariaDB akan digunakan sebagai database backend:

sudo apt install mariadb-server mariadb-client -y

Buat database dan user untuk Laravel:

CREATE DATABASE laraveldb;
CREATE USER 'laraveluser'@'localhost' IDENTIFIED BY 'passwordku';
GRANT ALL PRIVILEGES ON laraveldb.* TO 'laraveluser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4. Install mkcert

Install mkcert untuk SSL lokal:

sudo apt install mkcert -y

Install sertifikat Root CA dan membuat sertifikat untuk domain laravel.local:

mkcert -install
mkcert laravel.local

Pindahkan sertifkat dan private key SSL:

sudo mkdir -p /etc/apache2/ssl
sudo mv laravel.local.* /etc/apache2/ssl

5. Setup Domain Lokal

Tambahkan domain laravel.local ke hosts file:

echo "127.0.0.1 laravel.local" | sudo tee -a /etc/hosts

6. Buat Project Laravel

Buat project Laravel baru di /var/www:

cd /var/www
sudo composer create-project laravel/laravel laravelapp
sudo chown -R $USER:www-data laravelapp
sudo chmod -R 775 laravelapp

7. Konfigurasi Virtual Host

Buat konfigurasi untuk laravel.local:

sudo nano /etc/apache2/sites-available/laravel.local.conf

Masukkan konfigurasinya:

<VirtualHost *:80>
  ServerName laravel.local
  Redirect permanent / https://laravel.local/
</VirtualHost>

<VirtualHost *:443>
  ServerName laravel.local
  DocumentRoot /var/www/laravelapp/public

  SSLEngine on
  SSLCertificateFile /etc/apache2/ssl/laravel.local.pem
  SSLCertificateKeyFile /etc/apache2/ssl/laravel.local-key.pem
  
  <Directory /var/www/laravelapp/public>
    AllowOverride All
    Require all granted
  </Directory>
  
  ErrorLog ${APACHE_LOG_DIR}/laravel_error.log
  CustomLog ${APACHE_LOG_DIR}/laravel_access.log combined
</VirtualHost>

Aktifkan virtual host:

sudo a2ensite laravel.local.conf
sudo systemctl restart apache2

8. Konfigurasi .env

Edit file .env:

sudo nano /var/www/laravelapp/.env

Sesuaikan konfigurasinya:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laraveldb
DB_USERNAME=laraveluser
DB_PASSWORD=passwordku

9. Migrate Database

Jalankan migrasi database:

cd /var/www/laravelapp
php artisan migrate

Jika berhasil, tabel default Laravel akan dibuat di laraveldb.

10. Install Git

Install Git digunakan untuk version control project:

sudo apt install git -y
git --version

Konfigurasi identitas:

git config --global user.name "Nama Anda"
git config --global user.email "[email protected]"

Inisialisasi repository di project:

cd /var/www/laravelapp
git init
git add .
git commit -m "Inisialisasi project Laravel pertama"

11. Install Visual Studio Code

Install VS Code:

wget 'https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64' -O code.deb
sudo dpkg -i code.deb
sudo apt install -f

Agar coding lebih produktif, install extension berikut (Ctrl+Shift+X → search → Install):

PHP Intelephense – IntelliSense untuk PHP
Laravel Artisan – Menjalankan Artisan command langsung dari VS Code
Laravel Blade Snippets – Snippet & highlighting Blade template
Laravel Extra Intellisense – Auto-completion untuk helper Laravel
DotENV – Syntax highlighting .env
GitLens – Integrasi Git lebih lengkap

Membuka Laravel Project di VS Code

Masuk ke folder project:

cd /var/www/laravelapp
code .

Cara lain, buka VS Code → File → Open Folder → pilih /var/www/laravelapp.

12. Uji Aplikasi Laravel

Akses di browser:

https://laravel.local

Tambahkan route sederhana di routes/web.php:

Route::get('/hello', function () {
return "Hello, Laravel with Apache, MariaDB, SSL, and VS Code!";
});

Buka:

https://laravel.local/hello

Dengan langkah-langkah di atas, kita telah membangun Laravel development environment yang lengkap dan modern di Ubuntu:

Apache dengan SSL mkcert → aplikasi berjalan di domain lokal aman https://laravel.local.
PHP 8.3 (Ondřej PPA) → versi PHP terbaru dengan dukungan penuh untuk Laravel 10.
MariaDB → database relasional open-source yang ringan dan andal.
Composer + Laravel → dependency management dan framework PHP terbaik saat ini.
Visual Studio Code + Extension Laravel → pengalaman coding yang produktif dan nyaman dengan auto-completion, snippet, artisan command, dan integrasi Git.

Dengan setup ini, Anda tidak hanya bisa membangun aplikasi Laravel sederhana, tetapi juga mempersiapkan diri untuk project skala lebih besar. Lingkungan ini merepresentasikan best practice pengembangan modern dengan server, database, SSL, dan workflow yang mirip production.