TakeV
/
spacemacs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update php dap debugging doc to cover xdebug v3 and docker debug host issues.

This commit is contained in:
Alexander Konotop 2021-06-01 14:09:28 +03:00 committed by Maximilian Wolff
parent 70ec22703a
commit 12c4d510ff
2 changed files with 18 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
CHANGELOG.develop
View File

@ -3817,6 +3817,10 @@ files (thanks to Daniel Nicolai)
- layers/+lang/python/README.org
- Corrected typo in python language server install command (thanks to Zach
Pearson)
- layers/+lang/php/README.org
- Updated dap debugging manual to cover xdebug options which were changed
in xdebug v3. Added a caveat regarding host address usage while debugging
inside of docker container (thanks to Alexander Konotop)
*** Release notes summarized
Thanks to: Abhishek(Compro) Prasad, Deepak Khidia, Enze Chi, Grant Shangreaux,
Igor Almeida, Jiahao Jiang, Miciah Dashiel Butler Masters, Songpeng Zu, Ward

15
layers/+lang/php/README.org
View File

@ -97,12 +97,25 @@ installation command: =<M-x> dap-php-setup=.
After that You can try to debug something. For example add a breakpoint to any
of Your phpunit tests with =SPC m d b a=. And start debugging with =SPC m d d d=
and selecting a debug template. Now run the test to ensure everything is
working. The command to run the test while debugging could look like this:
working. You may refer to one of the following examples to run Your tests.
For xdebug v2:
#+BEGIN_SRC sh
php -d xdebug.idekey=PHPSTORM -d xdebug.remote_autostart=1 -d xdebug.remote_enable=1 -d xdebug.remote_host=127.0.0.1 -d xdebug.remote_port=9000 bin/phpunit ./path/to/Test.php
#+END_SRC
For xdebug v3:
#+BEGIN_SRC sh
php -d xdebug.idekey=PHPSTORM -d xdebug.start_with_request=yes -d xdebug.mode=debug -d xdebug.client_host=127.0.0.1 -d xdebug.client_port=9000 bin/phpunit ./path/to/Test.php
#+END_SRC
Make sure You use the proper host. For example both =localhost= and =127.0.0.1=
most likely will not work while debugging inside of docker. You have to use either
=host.docker.internal= or Your machine's external IP if it doesn't work.
See [[https://github.com/docker/for-linux/issues/264][this docker issue]] for reasons of troubles with =host.docker.internal=.
The test is now expected to be paused by emacs/dap when it catches code at the
breakpoint.