Debug PHP với X-Debug và VSCode (Phần 1)

1. Giới thiệu X-debug

- Trang chủ: https://xdebug.org/
- Xdebug là một phần mở rộng cho PHP và cung cấp nhiều tính năng để cải thiện trải nghiệm phát triển PHP.
- Xdebug yêu cầu phiên bản PHP được hỗ trợ. Để cài đặt, nó cần có công cụ pecl (có sẵn thông qua gói php-pear), trừ khi bản phân phối Linux của bạn có gói Xdebug (php-xdebug).
- Repo của Xdebug có sẵn tại https://github.com/xdebug/xdebug
- Xdebug có thể cài đặt được trên Linux, Windows, MacOS
Tài liệu này chỉ cung cấp hướng dẫn trên Windows

2. Cài đặt Xdebug

2.1 Xác định version php

- Sử dụng phương thức phpinfo() để lấy đầy đủ thông tin PHP

- Nhấn tổ hợp phím CTRL + A và CTRL + C để copy toàn bộ nội dung
- Truy cập link https://xdebug.org/wizard

+ Tại page wizard, paste nội dung đã copy vào ô trống và click vào button Analyse my phpinfo() output

- Sau khi submit sẽ được redirect vào page download file X-Debug
Click vào link download file php_xdebug

- Tại đây cũng có sẵn hướng dẫn các bước, tuy nhiên các bạn cần thay đổi đường dẫn cho phù hợp với môi trường của mình
- File download các bạn đưa vào folder extension của PHP
Đối với những bạn dùng xampp thì thông thường sẽ là xampp\php\ext, đối với những bạn dùng wamp thì là wamp64\bin\php\php7.2.18\zend_ext
- Theo dõi step 2.2 để config tiếp

2.2 Config PHP.ini

- Sử dụng đoạn code sau để lấy thông tin nơi lưu trữ file php.ini của bạn

public function index()
{
var_dump(php_ini_loaded_file(), php_ini_scanned_files());
}

- Sau khi truy cập bạn sẽ có thông tin như sau

- Mở file php.ini của bạn và thêm vào cuối file nội dung sau    
    Đối với Xdebug 3.x.x
    [XDebug]
    zend_extension=C:\xampp\php\ext\php_xdebug-3.1.6-7.4-vc15-x86_64.dll
    xdebug.mode = debug
    xdebug.discover_client_host = yes
    xdebug.log_level = 0
    xdebug.log = "%sprogdir%/userdata/temp/xdebug/log.txt"
    xdebug.start_with_request = yes
    xdebug.idekey = VSCODE
    xdebug.client_port = 9003
    
    Đối với Xdebug 2.x.x
    [XDebug]
    zend_extension=C:\xampp\php\ext\php_xdebug-3.1.6-7.4-vc15-x86_64.dll
    xdebug.remote_enable = 1
    xdebug.remote_autostart = 1
    xdebug.remote_port = 9000

- Sau đó truy cập vào phpinfo() để xem thông tin cấu hình như sau là thành công
- Nếu chưa thành công thì quay lại từ đầu