Xdebug Wrappers

Debugging CLI applications is a massive pain, because you usually don't have Xdebug enabled as it negatively affects performance of tools like phpunit or composer. You can enable xdebug inline in the command with -d argument. But not everyone is keen to remember obscure onliners. And you shouldn't! That's what Xdebug wrappers are for!

Instalation

• make sure you have xdebug correctly set up (see https://gist.github.com/tomasfejfar/4e8e27ece29b142a7ec7f54f4fa44872)
• add the executables to path
  • UNIX: symlink unix/xdebug to your path
  • WINDOWS: copy windows\xdebug.cmd (NOT the xdebug.bat) to your path - you'll never need to update this file, not even when updating xdebug wrappers
• (optional) create local config file
  • UNIX: ~/.config/xdebug-wrapper
  • WINDOWS: %UserProfile%\.config\xdebug_wrapper.bat

Usage in PhpStorm

• add a breakpoint in my-script.php
• in menu Run --> Start Listening for PHP Debug Connections
• run your CLI script xdebug my-script.php