Jak skonfigurować Xdebug w PHP na VS Code w kilka minut?

Aby zacząć, otwórz terminal i sprawdź swoją wersję PHP, wpisując polecenie 'php -v'. Pamiętaj, aby zapisać ten numer, ponieważ będzie potrzebny w dalszej konfiguracji. Następnie, zainstaluj Xdebug, uruchamiając polecenia: 'sudo apt update' oraz 'sudo apt install php-xdebug'. Jeśli używasz konkretnej wersji PHP, np. 8.2, możesz zainstalować bezpośrednio pakiet dla tej wersji: 'sudo apt install php8.2-xdebug'. Po instalacji sprawdź, czy Xdebug jest aktywne, wpisując 'php -m | grep xdebug'. Jeśli zobaczysz wynik, oznacza to, że instalacja powiodła się.

Jak skonfigurować Xdebug

Otwórz plik konfiguracyjny Xdebug, wpisując 'sudo nano /etc/php//mods-available/xdebug.ini'. Pamiętaj, aby zastąpić wersję PHP w ścieżce (np. 8.2). Wprowadź następujące ustawienia:

zend_extension=xdebug.so

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

Po zapisaniu pliku, zrestartuj serwer, aby zmiany zaczęły obowiązywać. Jeśli korzystasz z Apache, użyj polecenia 'sudo systemctl restart apache2'. W przypadku PHP-FPM, wpisz 'sudo systemctl restart php-fpm'.

Jak skonfigurować VS Code

W Visual Studio Code otwórz sekcję Rozszerzenia i wyszukaj 'PHP Debug', a następnie zainstaluj rozszerzenie autorstwa Xdebug. Następnie musisz stworzyć plik konfiguracyjny launch.json, który znajduje się w folderze .vscode twojego projektu. Wprowadź w nim następujący kod:

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

Otwórz swój projekt PHP w VS Code, dodaj punkt przerwania, a następnie naciśnij F5, aby rozpocząć nasłuch. Uruchom skrypt PHP lub otwórz swoją stronę internetową, a VS Code zatrzyma się w miejscu, gdzie ustawiłeś punkt przerwania. Na koniec, ponownie sprawdź wersję PHP, aby upewnić się, że Xdebug jest aktywne, a wszystko działa poprawnie.

Typowe problemy

Jeśli napotkasz problemy z konfiguracją, upewnij się, że port 9003 nie jest zablokowany przez zaporę, a także, że wszystkie ścieżki w plikach konfiguracyjnych są poprawne. Warto również zweryfikować, czy Apache lub PHP-FPM został poprawnie zrestartowany po wprowadzeniu zmian.

Dzięki tym krokom, użytkownicy będą mogli efektywnie debugować swoje aplikacje PHP, co znacznie ułatwi identyfikację błędów i poprawę jakości kodu.