Setting Subdomain di Laragon.

Catatan cara membuat beberapa subdomain lokal (misalnya portal.jayportal.test dan portal2.jayportal.test) di Laragon pada Windows. Berguna ketika satu proyek atau beberapa proyek terkait perlu dipisah per subdomain, lengkap dengan dukungan HTTPS lokal. Intinya: buat satu file virtual host yang mendefinisikan tiap site, daftarkan di file hosts, lalu tambahkan nama domain ke template SSL agar sertifikat lokal valid.

1. Buat file virtual host

Buka folder site Apache Laragon:

C:\laragon\etc\apache2\sites-enabled

Salin salah satu file auto.*.conf yang sudah ada (misalnya auto.domain.test.conf) sebagai titik awal, lalu ganti namanya dengan nama bebas, contoh domain.test.conf. Isi file dengan konfigurasi berikut. Setiap site didefinisikan dua kali: satu untuk port 80 (HTTP) dan satu untuk port 443 (HTTPS).

define ROOT1 "C:/laragon/www/jayportal"
define SITE1 "portal.jayportal.test"
define ROOT2 "C:/laragon/www/jayportal2/public"
define SITE2 "portal2.jayportal.test"

<VirtualHost *:80>
    DocumentRoot "${ROOT1}"
    ServerName ${SITE1}
    ServerAlias *.${SITE1}
    <Directory "${ROOT1}">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:443>
    DocumentRoot "${ROOT1}"
    ServerName ${SITE1}
    ServerAlias *.${SITE1}
    <Directory "${ROOT1}">
        AllowOverride All
        Require all granted
    </Directory>

    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php74-cgi
    </FilesMatch>

    SSLEngine on
    SSLCertificateFile      C:/laragon/etc/ssl/laragon.crt
    SSLCertificateKeyFile   C:/laragon/etc/ssl/laragon.key
</VirtualHost>

<VirtualHost *:80>
    DocumentRoot "${ROOT2}"
    ServerName ${SITE2}
    ServerAlias *.${SITE2}
    <Directory "${ROOT2}">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:443>
    DocumentRoot "${ROOT2}"
    ServerName ${SITE2}
    ServerAlias *.${SITE2}
    <Directory "${ROOT2}">
        AllowOverride All
        Require all granted
    </Directory>

    SSLEngine on
    SSLCertificateFile      C:/laragon/etc/ssl/laragon.crt
    SSLCertificateKeyFile   C:/laragon/etc/ssl/laragon.key
</VirtualHost>

Blok FilesMatch hanya diperlukan bila site itu memakai versi PHP tertentu (lihat catatan Dual PHP Laragon). Bila cukup dengan versi PHP default, blok tersebut boleh dihapus.

2. Konfigurasi file hosts

Tambahkan tiap subdomain ke file hosts Windows (C:\Windows\System32\drivers\etc\hosts) agar diarahkan ke localhost:

127.0.0.1      portal.jayportal.test
127.0.0.1      portal2.jayportal.test

Laragon biasanya bisa menambahkan entri ini otomatis (“Laragon magic”), tetapi menambahkannya manual memastikan subdomain tetap dikenali.

3. Tambahkan domain ke template SSL

Agar sertifikat SSL lokal Laragon valid untuk tiap subdomain, edit template OpenSSL di usr/tpl/openssl.conf.tpl dan daftarkan semua domain pada bagian alt_names:

[alt_names]
DNS.1 = localhost
DNS.2 = portal.jayportal.test
DNS.3 = portal2.jayportal.test

4. Restart dan regenerasi SSL

Restart Apache dari panel Laragon agar virtual host baru terbaca. Bila menambah domain baru ke template SSL, regenerasi sertifikat lewat Menu > Apache > SSL (Regenerate) supaya subdomain baru ikut tercakup dalam sertifikat.