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 atau myproject).

  • 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

Popular posts from this blog

Numpang Kerja Remote dari Bandung Creative Hub

Numpang Kerja Remote dari Bandung Digital Valley

Cara Decompile berkas Dex dan Apk Android