moodlehq / moodle-php-apache

PHP + Apache docker images for Moodle development
60 stars 68 forks source link

Document phpdbg / pcov / xdebug uses briefly #140

Open stronk7 opened 3 years ago

stronk7 commented 3 years ago

Over different issues (#137, https://github.com/moodlehq/moodle-docker/commit/46cccbeb6804c3979caf25d81ae05f08c59c3353, https://github.com/moodlehq/moodle-php-apache/issues/17#issuecomment-581877394...) there are spread comments and instructions about how to use phpdbg / pcov / xdebug with the PHP images.

This issue is about add some information about them in the README, so people doesn't have to look everywhere to know more about those 3 integrations (phpdbg / pcov for code coverage and xdebug for that and more).

This closes #17.

stronk7 commented 1 year ago

Just to note that phpdbg is far from ideal for PHP >= 8.0. It crashes all the time. More yet, I've read somewhere (cannot find the link) that it may be removed from php distros soon.

So, surely, when documenting that, we should, somehow, clarify that pcov > xdebug > (nonono) phpdbg are the preference. That, pretty much, matches what we do in moodle-plugin-ci (and surely other tools).

Ciao :-)