Debugging PHP Web dengan XDebug di Intellij IDEA (PHP STORM)
Untuk memaksimalkan efisiensi saat mengembangkan proyek Laravel, penggunaan alat debugging menjadi sangat penting. Di sinilah Xdebug berperan—ekstensi PHP yang memungkinkan kita untuk melacak alur eksekusi kode, memeriksa nilai variabel, dan menemukan bug dengan presisi tinggi.
Tutorial ini akan memandu Anda langkah demi langkah dalam menyatukan kekuatan Laravel, Xdebug, dan IntelliJ IDEA, salah satu IDE terbaik untuk pengembangan PHP. Kami akan membahas proses instalasi dan konfigurasi dari awal hingga akhir di lingkungan Ubuntu, memastikan Anda memiliki semua yang dibutuhkan untuk debugging yang mulus dan efisien. Mari kita mulai.
Langkah 1: Mempersiapkan Lingkungan Pengembangan
Pertama, pastikan Anda telah menginstal PHP, Composer, Node.js, dan npm di sistem Ubuntu Anda. Laravel memerlukan semua ini untuk bekerja dengan baik.
Meskipun tidak wajib, Node.js dan npm sangat penting dan hampir selalu digunakan dalam alur kerja pengembangan Laravel moder.
Langkah 2: Menginstal Xdebug
Untuk menginstal Xdebug, jalankan perintah ini di terminal Anda:
sudo apt-get install php-xdebug
Setelah instalasi selesai, Anda perlu memodifikasi file konfigurasi PHP (php.ini) untuk mengaktifkan Xdebug. Jalankan perintah berikut untuk menemukan lokasi file php.ini
Anda:
php --ini
Cari baris yang dimulai dengan Loaded Configuration File
. Buka file tersebut dengan editor teks favorit Anda (misalnya, nano
atau vim
):
sudo nano /etc/php/7.4/cli/php.ini
dan /etc/php/7.4/fpm/php.ini
dan /etc/php/7.4/apache2/php.ini
(ganti 7.4
dengan versi PHP Anda)
Tambahkan baris berikut di akhir file:
zend_extension=xdebug.so
xdebug.mode=debug
Simpan dan tutup file. Restart server web Anda jika Anda menggunakannya (misalnya, Apache atau Nginx).
Langkah 3: Menginstal Laravel
Jika Anda belum menginstal Laravel, Anda dapat melakukannya melalui Composer. Jalankan perintah ini di terminal untuk membuat proyek Laravel baru:
composer create-project laravel/laravel nama-proyek-anda
Masuk ke direktori proyek baru Anda:
cd nama-proyek-anda
Langkah 4: Konfigurasi Xdebug di IntelliJ IDEA
Buka proyek Laravel Anda di IntelliJ IDEA. Navigasikan ke Run > Edit Configurations.... Di jendela yang muncul, klik tombol +
di pojok kiri atas dan pilih PHP Remote Debug.
IDE key (session id): PHPSTORM
adalah sebuah kunci unik yang digunakan oleh Xdebug untuk mengidentifikasi IDE (Integrated Development Environment) yang sedang mendengarkan sesi debugging. Dalam hal ini, PHPSTORM
adalah nilai standar yang digunakan oleh IDE PhpStorm atau IntelliJ IDEA (ketika digunakan untuk pengembangan PHP) untuk berkomunikasi dengan Xdebug.
Bagaimana Cara Kerjanya?
Ketika Anda memulai sesi debugging (misalnya dengan mengklik tombol bookmarklet atau menambahkan parameter XDEBUG_SESSION_START=PHPSTORM
pada URL), Xdebug akan mengirimkan permintaan debug ke IDE. Untuk menghindari kebingungan jika ada beberapa IDE yang mendengarkan, Xdebug akan menyertakan IDE key
di dalam permintaannya.
IDE seperti IntelliJ IDEA akan memeriksa key ini. Jika key yang diterima cocok dengan key yang telah dikonfigurasi (PHPSTORM
), maka IDE akan menerima koneksi dan memulai sesi debugging. Jika tidak cocok, koneksi akan diabaikan. Ini memastikan bahwa sesi debugging terhubung ke IDE yang benar.
Name: Beri nama konfigurasi ini, misalnya, "Xdebug Laravel".
Filter debug connection by IDE key: Centang opsi ini.
IDE key (session id): Masukkan
PHPSTORM
.
Selanjutnya, klik ...
di samping Server untuk mengonfigurasi server Anda. Di jendela Servers yang muncul:
Name: Beri nama server (misalnya,
localhost
ataumyproject
).Host: Masukkan
127.0.0.1
.Port: Masukkan
9003
.Debugger: Pilih Xdebug.
Klik Apply dan kemudian OK. Kembali ke jendela Run/Debug Configurations, pastikan server yang baru saja Anda buat terpilih. Klik Apply dan OK untuk menyimpan konfigurasi.
Langkah 5: Memulai Debugging
Anda sekarang siap untuk memulai debugging. Di IntelliJ IDEA, Jalankan project dan debugger bersamaan.
Atur breakpoint di kode Anda dengan mengklik di margin kiri baris kode yang ingin Anda debug.
Untuk memulai sesi debugging, buka proyek Anda di browser. Xdebug akan otomatis terhubung ke IntelliJ IDEA. Anda akan melihat eksekusi kode berhenti di breakpoint yang Anda atur, dan Anda dapat menelusuri kode, memeriksa variabel, dan melacak alur eksekusi.
Selamat, Anda telah berhasil menyiapkan Xdebug untuk proyek Laravel Anda di IntelliJ IDEA!
Comments
Post a Comment