the possibility to step (!) debug requests, as they appear on the server is a neat feature, xdebug + eclipse are a great team, when the setup is complete.

  • installed GNU Linux Debian 11 + MATE Desktop
  • installed apache2 + php8.1
  • installed eclipse
  • installed xdebug
    • and as usually, xdebug + eclipse do not like to cooperate out of the box, why?
    • (result is the “classic” eclipse hanging on progress” “of 75%” (or some other %) when trying to start a debug session“, so also here more accurate error messages would have helped the developer debug the problem like after a 30sec timeout “xdebug did not connect within 30 sec to port 9000, wrong port?”)
    • because they could not agree on what port to use per default
      • latest eclipse wants to connect to xdebug per default on port 9000
      • latest xdebug wants to connect to eclipse per default on por 9003
      • c’mon, get in contact with each other and set a standard 🙂
      • (this has cost me about 2h of debugging around eclipse and ini files)
  • below (older) guide is still usable:

how to setup basic LAMP stack GNU Linux Debian – (Apache2 php7.3 MariaDB) (how to install xdebug – step debugging php requests in eclipse pdt on debian 10 buster (LAMP web development stack))

    • php -v; # is also a good way to test if xdebug is loaded when php is started
      vim /etc/php/8.1/apache2/php.ini; # no xdebug related settings are here
      vim /etc/php/8.1/cli/conf.d/20-xdebug.ini; # they are all here and read like:
      xdebug.start_with_request = 1
      xdebug.remote_autostart = on
      xdebug.log_level = 7
      xdebug.profiler_enable_trigger = 1
      xdebug.profiler_enable = 0
      xdebug.remote_enable = 1
      xdebug.profiler_output_dir = "/tmp"
      systemctl restart apache; # changes need to be made active by restarting webserver
  • when everything is installed go to eclipse -> window -> preferences
    • and also here:
  • if the developer r-click in the empty white space next to the code ->
  • sees this message…
      • releave… good god thanks they are talking to each other!


download the results:

  1. install (available for GNU Linux, OSX, Windows)
  2. wget
  3. (3.2Gbytes) wget
  4. sha512sum -c devPHP_Debian_11_XDebug+Eclipse_php8.1_usr_root_pwd_root.tar.xz.sha512sum.txt
    • checksum ok? -> continue otherwise: redownload
  5. unpack tar fcvJ devPHP_Debian_11_XDebug+Eclipse_php8.1_usr_root_pwd_root.tar.xz
  6. doule click the vbox file
  7. usr: user pwd: user, usr: root pwd: root (change both as soon as possible!)
  8. start the vm 🙂

by the way:

what is btw excellent done is this “Open Source project funding and progress status page”:

so every user can see, what is the progress “where is it hanging” of the software project, is it a lack of funding?

suggestion: what still missing a “still todo” todo list, where user’s can post suggestions and vote on features 🙂