Hướng dẫn Debug PHP với Xdebug trên Laragon 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 Laragon để debug PHP dễ dàng trong VS Code.

1. Kiểm tra PHP version

Trong Laragon bấm Terminal hoặc mở CMD rồi chạy:

php -v

Ví dụ:

PHP 8.2.x (cli) ...

---

2. Tải Xdebug đúng version

1. Tạo file info.php trong thư mục web (vd: C:\laragon\www\test\info.php):

   <?php phpinfo();

   Rồi mở trên trình duyệt: http://localhost/info.php

2. Copy toàn bộ output → vào Xdebug Wizard → paste vào.
   Nó sẽ gợi ý file .dll phù hợp với PHP 8.2 mà Laragon đang dùng.

3. Tải file .dll về (vd: php_xdebug-3.3.1-8.2-vs16-x64.dll).

4. Đặt file này vào:

   C:\laragon\bin\php\php-8.2.x\ext\

---

3. Cấu hình php.ini

Trong Laragon, PHP có 2 file cấu hình quan trọng:

• CLI: C:\laragon\bin\php\php-8.2.x\php.ini

• Apache/Nginx: C:\laragon\bin\apache\httpd-2.x.x\bin\php.ini (nếu bạn dùng Apache)

👉 Để chắc ăn, bạn sửa file trong C:\laragon\bin\php\php-8.2.x\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:\laragon\bin\php\php-8.2.x\ext\php_xdebug-3.3.1-8.2-vs16-x64.dll"

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

⚠️ Trong Xdebug 3.x (PHP 8.x), mặc định dùng port 9003, không còn 9000 nữa.

Sau đó Restart Laragon.

---

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

Chạy:

php -v

Bạn sẽ thấy dòng kiểu:

with Xdebug v3.3.x, Copyright (c) 2002-2024, by Derick Rethans

Hoặc mở lại info.php, kéo xuống 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 (vd: index.php).

2. Trong VS Code, chọn Listen for Xdebug rồi bấm F5.

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

4. VS Code sẽ dừng code ở breakpoint.

Xem thêm:

• Trang chủ Xdebug
• Cài đặt Xdebug cho PHP 8.x và debug bằng VS Code
• Cài đặt Xdebug PHP 8.x trên XAMPP để debug với VS Code