Hướng dẫn Debug PHP với Xdebug trên XAMPP bằng VS Code (PHP 8.x)

Trong bài viết này, bạn sẽ học cách cài đặt Xdebug để debug PHP 8.x trên XAMPP để debug PHP dễ dàng trong VS Code.

1. Kiểm tra PHP version

Trong XAMPP mở Shell hoặc CMD chạy:

php -v

Ví dụ output:

PHP 8.2.x (cli) ...

---

2. Tải Xdebug đúng version

1. Mở http://localhost/dashboard/phpinfo.php hoặc tạo file info.php trong htdocs:

   <?php phpinfo();

2. Copy toàn bộ nội dung trang phpinfo()
   → Vào Xdebug Wizard → paste vào → nó sẽ gợi ý file .dll đúng cho PHP 8.2 của bạn.

3. Tải file .dll về (ví dụ: php_xdebug-3.3.1-8.2-vs16-x86_64.dll).

4. Đặt file vào thư mục:

   C:\xampp\php\ext\

---

3. Cấu hình php.ini

Mở file:

C:\xampp\php\php.ini

Tìm và xóa/comment dòng cũ zend_extension=...xdebug... nếu có.
Thêm đoạn sau cuối file:

zend_extension="C:\xampp\php\ext\php_xdebug-3.3.1-8.2-vs16-x86_64.dll"

[xdebug]
xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9003

⚠️ Lưu ý: Xdebug 3.x (PHP 8.x) mặc định dùng port 9003 chứ không phải 9000.

Sau đó restart Apache trong XAMPP Control Panel.

---

4. Kiểm tra Xdebug đã bật chưa

Chạy lại:

php -v

Hoặc mở lại info.php, bạn sẽ thấy block Xdebug.

---

5. Cấu hình VS Code

1. Cài extension PHP Debug (Felix Becker).

2. Vào menu Run and Debug (Ctrl+Shift+D) → create a launch.json → chọn PHP.

3. File .vscode/launch.json sẽ có nội dung:

   {
     "version": "0.2.0",
     "configurations": [
       {
         "name": "Listen for Xdebug",
         "type": "php",
         "request": "launch",
         "port": 9003
       }
     ]
   }
   

---

6. Debug

1. Đặt breakpoint trong file PHP (ví dụ index.php).

2. Trong VS Code bấm F5 (chọn “Listen for Xdebug”).

3. Mở trình duyệt vào http://localhost/your_project/.

4. Code sẽ dừng ngay tại breakpoint trong VS Code.

Xem thêm:

• Trang chủ Xdebug

• PHP Debug extension for VS Code