Cara Menghubungkan Nginx dengan PHP di Ubuntu Server
Cara Menghubungkan Nginx dengan PHP di Ubuntu Server. Banyak pemula berhenti di tengah jalan saat setup server karena Nginx dan PHP tidak terhubung dengan benar. Akibatnya? File PHP tidak tampil, malah ter-download atau error.
Tenang—di artikel ini Anda akan belajar cara menghubungkan Nginx dengan PHP-FPM di Ubuntu Server dengan benar dan tanpa ribet.
🧠 Kenapa Nginx Butuh PHP-FPM?
Berbeda dengan Apache, Nginx tidak bisa menjalankan PHP secara langsung.
Solusinya:
👉 Menggunakan PHP-FPM (FastCGI Process Manager) sebagai perantara.
Alur kerjanya:
- Nginx menerima request
- PHP-FPM memproses file PHP
- Hasil dikirim kembali ke browser
⚙️ Persiapan Sebelum Konfigurasi
Pastikan:
- Nginx sudah terinstall
- PHP-FPM sudah terinstall
- Server Ubuntu aktif
Cek service:
sudo systemctl status nginx
sudo systemctl status php*-fpm
📝 Edit Konfigurasi Nginx
Buka file default config:
sudo nano /etc/nginx/sites-available/default
✏️ 1. Tambahkan Index PHP
Cari bagian ini:
index index.html index.htm;
Ubah menjadi:
index index.php index.html index.htm;
⚡ 2. Aktifkan Konfigurasi PHP
Cari bagian yang dikomentari (biasanya ada location ~ \.php$) lalu ubah menjadi:
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.x-fpm.sock;
}
📌 Penting:
- Sesuaikan
php8.xdengan versi PHP Anda - Cek versi dengan:
php -v
🔍 Cek Konfigurasi Nginx
Sebelum restart, pastikan tidak ada error:
sudo nginx -t
Jika muncul:
syntax is ok
berarti aman ✅

🔄 Restart Service
sudo systemctl restart nginx
🧪 Test Integrasi PHP
Buat file test:
sudo nano /var/www/html/info.php
Isi:
<?php phpinfo(); ?>
Buka di browser:
http://IP-Server-Anda/info.php
Jika halaman PHP muncul → integrasi berhasil 🎉
❌ Troubleshooting Error Umum
1. File PHP Ter-download
👉 Penyebab: konfigurasi PHP belum aktif
✔️ Solusi: cek blok location ~ \.php$
2. Error 502 Bad Gateway
👉 Penyebab: PHP-FPM tidak berjalan
✔️ Solusi:
sudo systemctl restart php8.x-fpm
3. Socket Tidak Ditemukan
👉 Penyebab: path salah
✔️ Solusi:
ls /var/run/php/
Sesuaikan dengan file .sock yang ada
⚠️ Tips Penting
- Selalu cek config sebelum restart
- Gunakan versi PHP yang stabil
- Backup file config sebelum edit
- Gunakan log untuk debugging:
/var/log/nginx/error.log
🎯 Kesimpulan
Menghubungkan Nginx dengan PHP adalah langkah krusial dalam membangun server berbasis LEMP. Jika konfigurasi ini berhasil, Anda sudah siap menjalankan berbagai aplikasi web modern.
Leave a Reply