xD bug - Jak debugować PHP-owe aplikacje (Xdebug)
0 likes•1,658 views
#LaravelPolandMeetup #23 Laravel Poland MeetUp #23 online Temat: xD bug - jak debugować PHP-owe aplikacje (Xdebug) Garść praktycznych informacji o debuggowaniu aplikacji Autor: Marcin Tracz, Blumilk
xD bug - Jak debugować PHP-owe aplikacje (Xdebug)
- 1. xD bug - jak debugować PHP-owe aplikacje (Xdebug)
- 2. Marcin Tracz Software developer w Blumilk [email protected]
- 3. Agenda ➔ Debugowanie interaktywne i nie interaktywne ➔ Xdebug - co i jak ➔ Xdebug - instalacja ➔ Xdebug - konfiguracja ➔ Xdebug - wywołanie sesji debugowania (WEB) ➔ PHPStorm konfiguracja ➔ Visual Studio Code konfiguracja ➔ Xdebug - wywołanie sesji debugowania (CLI) ➔ Xdebug, PHPStorm, Docker ➔ PHPStorm debugowanie testów, skryptów ➔ Zdalne debugowanie ◆ SSH ◆ NGROK ◆ Xdebug Cloud ◆ DBGproxy ➔ Xdebug alternatywy
- 4. Debugowanie aplikacji PHP interactive debugging non-interactive debugging
- 5. Xdebug?
- 6. Nie działa to debagołanie
- 7. Xdebug - ogólny zarys ➔ Derick Rethans ➔ 2002 rok ➔ open source ➔ PHP extension (PECL package https://pecl.php.net/package/xdebug) ➔ https://xdebug.org/ ➔ https://github.com/xdebug/xdebug ➔ aktualne stabilne wydanie na dzień 9.11.2022: 3.1.6 (z dnia 8.11.2022) ➔ aktualne beta wydanie na dzień 5.11.2022: 3.2.0RC1 (z dnia 10.10.2022) ➔ pierwsze wydanie: 0.6.0 (z dnia 25.04.2002) https://github.com/xdebug/xdebug/releases/tag/0.6.0 https://github.com/xdebug/xdebug/tags?after=1.2.0rc2
- 8. Protokół DBGp Specyfikacja protokołu: https://xdebug.org/docs-dbgp.php Wersja: 1.0 Autorzy: - Shane Caraveo, ActiveState - Derick Rethans Protokół zapewnia komunikację między silnikiem debuggera (np. Xdebug), a IDE debuggera (np. PHPStorm, VS Code). Silnik debugera (Xdebug) inicjuje sesję debugowania. Silnik debuggera nawiązuje połączenie z nasłuchującym IDE, a następnie czeka, aż IDE zainicjuje polecenia.
- 10. Jak to działa? 1. IDE nasłuchuje na porcie 9000 2. Użytkownik wysyła request inicjując sesję debugowania, do Xdebug. (parametr XDEBUG_SESSION_START) 3. Xdebug rozpoczyna sesję debugowania i próbuje nawiązać połączenie do IDE. Wysyła pakiet INIT i czeka. Nie wykonuje jeszcze żadnego kodu. 4. IDE negocjuje funkcje lub ustawia dowolne punkty przerwania 5. IDE wysyła polecenia, aby interaktywnie przechodzić przez kod Xdebug v2 config params! źródło https://crosp.net/blog/software-development/web/php/understanding-and-using-xdebug-with-phpstorm-and-magento-remotely/
- 11. Jak to działa? źródło https://crosp.net/blog/software-development/web/php/understanding-and-using-xdebug-with-phpstorm-and-magento-remotely/ Xdebug v2 config params!
- 12. Xdebug - a wersje PHP źródło https://xdebug.org/docs/compat#versions
- 14. Instalacja - przez PECL
- 16. xdebug_info();
- 17. xdebug_info();
- 18. Wywołanie sesji debugowania - WEB ➔ parametr GET/POST, XDEBUG_SESSION, XDEBUG_SESSION_START, XDEBUG_TRIGGER ➔ ręczne dodanie ciastka (cookie) XDEBUG_SESSION z pomocą przychodzą wtyczki w przeglądarkach ◆ Xdebug Helper - Firefox ◆ Xdebug helper - Chrome ◆ Xdebug helper - Microsoft Edge ◆ XDebugToggle - Safari ➔ Xdebug będzie zawsze próbował zainicjować sesję debugowania Aby wyłączyć sesję debugowania, usuń ciastko, lub wyłącz z poziomu wtyczki w przeglądarce. Ewentualnie parametr XDEBUG_SESSION_STOP
- 20. Konfiguracja - PHPStorm (2022.2.3)
- 22. Konfiguracja - PHPStorm NIE nasłuchuje na połączenia Xdebug Nasłuchuje na połączenia Xdebug
- 25. Znów nie działa to debagołanie. Pokaż, nosz kur** Może płyty nie ma?
- 29. PHPStorm - opcje Xdebug https://www.jetbrains.com/help/phpstorm/debug-tool-window.html 1 2 3
- 30. PHPStorm - opcje Xdebug
- 31. Konfiguracja
- 32. Konfiguracja
- 33. Konfiguracja - Visual Studio Code
- 34. Konfiguracja - Visual Studio Code
- 35. Konfiguracja - Visual Studio Code 1 2 3
- 36. Konfiguracja - Visual Studio Code
- 37. Wywołanie sesji debugowania - CLI ➔ env variable, XDEBUG_SESSION, XDEBUG_TRIGGER, XDEBUG_CONFIG wartość tych zmiennych nie ma znaczenia, dopóki nie ustawisz ręcznie xdebug.trigger_value
- 38. Wywołanie sesji debugowania - CLI
- 39. Wywołanie sesji debugowania - CLI
- 40. Debugowanie skryptów CLI, np. kolejki JOB REDIS JOB JOB KOLEJKA
- 41. Debugowanie skryptów CLI - PHPStorm way
- 42. Debugowanie skryptów CLI - PHPStorm way
- 43. Wywołanie sesji debugowania podczas błędu kiedy wystąpi: PHP Notice lub Warning kiedy zostanie rzucony wyjątek: Throwable (Error lub Exception)
- 44. Mam 2 aplikacje backendowe - co robić, jak żyć? app1 app2 HTTP request + poprawna konfiguracja client_host
- 51. Xdebug, PHPStorm, Docker LOCAL DOCKER NETWORK PHP APP in container HOST? LOCALHOST
- 52. HOST address inside Docker
- 53. HOST address inside Docker Mac: host.docker.internal / docker.for.mac.host.internal (replaces docker.for.mac.localhost) Windows: host.docker.internal / docker.for.win.host.internal (replaces docker.for.win.localhost) Linux: host.docker.internal - Windows/Mac Docker version >= 18.03 - Linux Docker version >= 20.10.0 host.docker.internal https://github.com/moby/moby/pull/40007
- 54. HOST address inside Docker Windows Mac Linux
- 55. HOST address inside Docker host.docker.internal:host-gateway BEZ Z
- 56. HOST address inside Docker
- 58. HOST address inside Docker https://docs.docker.com/desktop/networking/#i-want-to-connect-from-a-container-to-a-service-on-the-host
- 59. host-gateway in Docker on Linux https://github.com/docker/cli/blob/master/opts/hosts.go
- 60. IP Hosta w kontenerze
- 64. PHPStorm debugowanie widoków Blade /storage/framework/views
- 65. PHPStorm debugowanie widoków Blade
- 66. Xdebug a wydajność aplikacji? Xdebug spowalnia wydajność aplikacji! “XDebug checks each HTTP request for the existance of a specific URL parameter or a cookie in order to determine if it should be activated or not”
- 67. Xdebug logs Brak parametru i ciastka, do wywołania sesji debugowania!
- 68. Xdebug logs - mode debug
- 69. Xdebug logs - mode debug Zainicjowanie sesji debugowania (parametr lub ciastko).
- 70. Xdebug logs - mode debug
- 71. Xdebug logs - mode develop BRAK LOGÓW
- 72. Xdebug a testy? Xdebug spowalnia testy!
- 73. Xdebug a testy?
- 74. Zdalne debugowanie Możliwe opcje: ➔ Publiczne IP + przekierowania portów na routerze ➔ Tunel SSH (reverse SSH port forwarding) ➔ NGROK ➔ Xdebug Cloud Jeśli jesteś w innej sieci niż serwer z aplikacją PHP, którą musisz debugować, możesz mieć problem. Xdebug ze zdalnego serwera nie może bezpośrednio połączyć się z Twoją maszyną przez wszystkie zapory, routery NAT lub inną infrastrukturę sieciową. developer IDE PHP app with Xdebug local internet
- 75. Zdalne debugowanie - tunel SSH 1. local port forwarding 2. remote port forwarding (reverse tunneling) źródło https://goteleport.com/blog/ssh-tunneling-explained/ źródło https://docs.devsense.com/en/vs/debugging/remote-debug-via-ssh Opcja -R instruuje klienta SSH, aby przekazał port 9003 ze zdalnej maszyny do miejsca, na localhost:9003, gdzie Debugger (IDE) będzie nasłuchiwał. E
- 76. Zdalne debugowanie - NGROK źródło https://ngrok.com/ na dzień 7.11.2022
- 77. Xdebug Cloud - beta https://xdebug.cloud/ ➔ 2021 rok ➔ płatne ➔ tylko dla firm ➔ multi - user debugging (kilka jednoczesnych sesji debugowania) Dokumentacja: https://xdebug.cloud/docs źródło: https://xdebug.cloud/signup
- 78. Xdebug Cloud - beta Xdebug Cloud developer IDE aplikacja (z Xdebug) Xdebug session trigger request (with XDEBUG_SESSION param/cookie) local internet źródło: https://xdebug.cloud/ źródło: opracowanie własne
- 79. Xdebug Cloud - cennik Na dzień 5.11.2022 źródło: https://xdebug.cloud/signup
- 80. Xdebug Cloud - dashboard źródło: https://www.youtube.com/watch?v=Jny-RJDf2AM
- 81. Multi user debugging - DBGproxy źródło: https://xdebug.org/docs/dbgpProxy źródło: https://xdebug.org/download#dbgpProxy
- 82. Multi user debugging - DBGproxy źródło: https://blog.gougousis.net/xdebug-walkthrough/
- 83. Alternatywy dla Xdebug debugger: ➔ Zend Debugger paczki: ➔ Ray (Spatie) https://github.com/spatie/ray - płatne ➔ tracy (Nette) https://github.com/nette/tracy ➔ kint https://github.com/kint-php/kint/