Cách kích hoạt mô-đun Xdebug đi kèm của ServBay

Là một công cụ phát triển Web tích hợp mạnh mẽ, ServBay đi kèm với mô-đun Xdebug và quá trình kích hoạt rất đơn giản. Xdebug là một công cụ gỡ lỗi và phân tích PHP, giúp các nhà phát triển thực hiện gỡ lỗi mã, phân tích hiệu năng và kiểm tra độ bao phủ mã, là công cụ mạnh mẽ để phát triển và duy trì ứng dụng PHP.

Giới thiệu mô-đun Xdebug

Xdebug là một tiện ích mở rộng PHP mạnh mẽ, dùng để gỡ lỗi và phân tích mã PHP. Nó cung cấp nhiều chức năng gỡ lỗi, bao gồm gỡ lỗi theo điểm dừng, theo dõi ngăn xếp, giám sát biến, v.v. Ngoài ra, Xdebug còn hỗ trợ phân tích hiệu năng và kiểm tra độ bao phủ mã, giúp các nhà phát triển tối ưu hóa hiệu quả mã và đảm bảo chất lượng mã.

Đặc điểm chính

1. Gỡ lỗi theo điểm dừng: Xdebug hỗ trợ thiết lập điểm dừng trong mã, gỡ lỗi từng dòng một, dễ dàng tìm và sửa lỗi.
2. Theo dõi ngăn xếp: Khi xảy ra lỗi, Xdebug có thể tạo thông tin theo dõi ngăn xếp chi tiết, giúp nhà phát triển nhanh chóng xác định vấn đề.
3. Phân tích hiệu năng: Xdebug cung cấp chức năng phân tích hiệu năng, có thể tạo báo cáo hiệu năng chi tiết, giúp nhà phát triển tối ưu hóa hiệu quả mã.
4. Độ bao phủ mã: Xdebug hỗ trợ phát hiện độ bao phủ mã, giúp nhà phát triển đảm bảo các bài kiểm tra đã bao phủ tất cả các đường dẫn mã.
5. Hỗ trợ môi trường phát triển tích hợp: Xdebug có thể tích hợp với nhiều môi trường phát triển tích hợp (IDE) như PHPStorm, Visual Studio Code, cung cấp trải nghiệm gỡ lỗi thuận tiện.

Phiên bản mô-đun Xdebug đi kèm của ServBay

ServBay hỗ trợ nhiều phiên bản PHP và đi kèm với mô-đun Xdebug tương ứng cho mỗi phiên bản. Cụ thể như sau:

• PHP 5.6, 7.0, 7.1: Xdebug 2.5.5
• PHP 7.2, 7.3, 7.4: Xdebug 3.1.6
• PHP 8.0, 8.1, 8.2, 8.3: Xdebug 3.3.1
• PHP 8.4: Xdebug 3.4.0-dev

Thông báo

Cổng Xdebug của mỗi phiên bản PHP là độc lập và liên kết với số phiên bản, ví dụ, cổng Xdebug của PHP 7.2 là 39072, của PHP 8.3 là 39083.

Cách kích hoạt mô-đun Xdebug

Theo mặc định, mô-đun Xdebug bị vô hiệu hóa. Các bước để kích hoạt mô-đun Xdebug rất đơn giản, chỉ cần điều hướng tới Ngôn ngữ - PHP, chọn phiên bản PHP cần kích hoạt mô-đun, ví dụ PHP 8.4, nhấn Tiện ích ở bên phải, sau đó bật công tắc bên trái của mô-đun Xdebug, và lưu.

Người dùng cũng có thể tự mở hoặc chỉnh sửa cấu hình mô-đun, dưới đây là các bước chi tiết:

Bước 1: Tìm tệp cấu hình

Trước tiên, định vị tới thư mục conf.d của phiên bản PHP tương ứng. Ví dụ, để kích hoạt mô-đun Xdebug cho PHP 8.3, chúng ta cần chỉnh sửa tệp sau:

/Applications/ServBay/etc/php/8.3/conf.d/xdebug.ini

Bước 2: Chỉnh sửa tệp cấu hình

Mở tệp xdebug.ini, bỏ dấu chú thích của nội dung sau:

[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so

Bước 3: Cấu hình tham số Xdebug

Để tận dụng tối đa chức năng của Xdebug, có thể cấu hình một số tham số thông dụng trong xdebug.ini. Ví dụ:

xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

Bước 4: Khởi động lại dịch vụ PHP

Trong bảng điều khiển quản lý dịch vụ của ServBay, khởi động lại dịch vụ PHP tương ứng. Ví dụ, khởi động lại dịch vụ PHP 8.3. Sau khi khởi động lại, mô-đun Xdebug sẽ được tải thành công.

Kiểm tra mô-đun Xdebug đã tải thành công chưa

Có thể kiểm tra bằng cách tạo một tệp PHP đơn giản để xem mô-đun Xdebug đã tải thành công chưa. Tạo tệp phpinfo.php trong thư mục gốc của máy chủ web, nội dung như sau:

<?php
phpinfo();
?>

Truy cập https://servbay.host/phpinfo.php, và kiểm tra thông tin liên quan đến mô-đun Xdebug trên trang thông tin PHP xuất ra. Nếu thấy thông tin của Xdebug, nghĩa là mô-đun đã được tải thành công.

Cấu hình Xdebug trong PHPStorm

Để sử dụng Xdebug với PHPStorm để gỡ lỗi, cần thực hiện các bước cấu hình sau:

Bước 1: Mở PHPStorm và vào phần cài đặt

1. Mở PHPStorm.
2. Nhấn vào File trên menu, sau đó chọn Settings (Windows/Linux) hoặc Preferences (macOS).

Bước 2: Cấu hình trình thông dịch PHP

1. Trong cửa sổ cài đặt, điều hướng tới Languages & Frameworks -> PHP.
2. Trong phần CLI Interpreter, nhấn vào nút ... bên phải.
3. Trong cửa sổ bật ra, nhấn nút + để thêm trình thông dịch PHP mới, chọn Local.
4. Đặt đường dẫn trình thông dịch PHP là đường dẫn của phiên bản PHP tương ứng trong ServBay, ví dụ /Applications/ServBay/package/php/8.3/8.3.7/bin/php.
5. Nhấn OK để lưu cài đặt.

Bước 3: Cấu hình gỡ lỗi Xdebug

Thông báo

Cổng Xdebug của mỗi phiên bản PHP là độc lập và liên kết với số phiên bản, ví dụ, cổng Xdebug của PHP 7.2 là 39072, của PHP 8.3 là 39083.

1. Trong cửa sổ cài đặt, điều hướng tới Languages & Frameworks -> PHP -> Debug.
2. Trong phần Xdebug, thiết lập Debug Port là 39083, giống với cấu hình xdebug.client_port.
3. Đảm bảo rằng tùy chọn Can accept external connections đã được chọn.
4. Nhấn Apply rồi nhấn OK để lưu cài đặt.

Bước 4: Cấu hình máy chủ ứng dụng PHP

1. Trong cửa sổ cài đặt, điều hướng tới Languages & Frameworks -> PHP -> Servers.
2. Nhấn vào nút + bên phải để thêm cấu hình máy chủ mới.
3. Đặt tên máy chủ, ví dụ ServBay Localhost.
4. Đặt Host là host tương ứng trong ServBay, như servbay.new, và cổng là 443 (HTTPS).
5. Đặt Debugger là Xdebug.
6. Nhấn OK để lưu cài đặt.

Bước 5: Khởi động phiên gỡ lỗi

1. Trong PHPStorm, mở dự án PHP bạn muốn gỡ lỗi.
2. Đặt điểm dừng trong mã (bằng cách nhấp vào khu vực trống bên trái của số dòng).
3. Nhấn vào nút Start Listening for PHP Debug Connections (biểu tượng con bọ) trên thanh công cụ của PHPStorm.
4. Truy cập vào ứng dụng PHP của bạn trong trình duyệt, Xdebug sẽ tự động kết nối với PHPStorm và dừng lại tại điểm dừng.

Kết luận

ServBay cung cấp cách nhanh chóng để quản lý và kích hoạt mô-đun Xdebug. Với các cấu hình đơn giản và thao tác khởi động lại, nhà phát triển có thể nhanh chóng kích hoạt được mô-đun Xdebug trên các phiên bản PHP khác nhau, từ đó tận dụng các chức năng mạnh mẽ của nó để gỡ lỗi và phân tích, nâng cao hiệu quả phát triển và bảo trì ứng dụng PHP. Chức năng gỡ lỗi theo điểm dừng, phân tích hiệu năng và độ bao phủ mã của Xdebug khiến nó trở thành công cụ không thể thiếu của các nhà phát triển PHP.