\/etc\/systemd\/system\/php-fpm-xdebug.service<\/code> and changed the paths to avoid conflicts:<\/p>\n\n\n\n[Unit]\nDescription=The PHP 8.0 FastCGI Process Manager (with xdebug)\nDocumentation=man:php-fpm8.0(8)\nAfter=network.target\n\n[Service]\nType=notify\nExecStart=\/usr\/sbin\/php-fpm8.0 --nodaemonize --fpm-config \/etc\/php\/8.0\/fpm-xdebug\/php-fpm.conf -c \/etc\/php\/8.0\/fpm-xdebug\nExecStartPost=-\/usr\/lib\/php\/php-fpm-socket-helper install \/run\/php\/php-fpm-xdebug.sock \/etc\/php\/8.0\/fpm-xdebug\/pool.d\/www.conf 80\nExecStopPost=-\/usr\/lib\/php\/php-fpm-socket-helper remove \/run\/php\/php-fpm-xdebug.sock \/etc\/php\/8.0\/fpm-xdebug\/pool.d\/www.conf 80\nExecReload=\/bin\/kill -USR2 $MAINPID\n\n[Install]\nWantedBy=multi-user.target<\/code><\/pre>\n\n\n\n\/etc\/php\/8.0\/fpm-xdebug<\/code> is the configuration directory for the new instance of PHP-FPM, initially based on a copy of \/etc\/php\/8.0\/fpm<\/code>. To avoid loading Xdebug into the non-Xdebug instance, I commented out the zend_extension line in \/etc\/php\/8.0\/mods-available\/xdebug.ini<\/code> , since the package has a bug which recreates the conf.d<\/code> symlinks if you delete them. <\/p>\n\n\n\nI don’t usually use the default php.ini<\/code>, I just wipe it after package installation and start with an empty file, since that makes it easier to see which defaults I’ve overridden. You lose the documentation comments, but I’m able to read the manual, so that’s fine.<\/p>\n\n\n\nMy \/etc\/php\/8.0\/fpm-xdebug\/php.ini<\/code> has:<\/p>\n\n\n\nzend_extension = xdebug.so\nxdebug.mode = debug\nxdebug.client_host = 169.254.1.1<\/code><\/pre>\n\n\n\nReplace 169.254.1.1 with the address of the host on which your IDE runs, as seen by the container. I am using systemd-nspawn with bridged networking, which allows PHP to connect to the host using link-local addresses.<\/p>\n\n\n\n
A few more little things to avoid conflicts with the main PHP-FPM instance. Like php.ini<\/code>, I started with empty files, not default files. \/etc\/php\/8.0\/fpm-xdebug\/php-fpm.conf<\/code> contains only:<\/p>\n\n\n\n[global]\npid = \/run\/php\/php8.0-fpm-xdebug.pid\nerror_log = \/var\/log\/php8.0-fpm-xdebug.log\n\ninclude=\/etc\/php\/8.0\/fpm-xdebug\/pool.d\/*.conf<\/code><\/pre>\n\n\n\nAnd \/etc\/php\/8.0\/fpm-xdebug\/pool.d\/www.conf<\/code>:<\/p>\n\n\n\n[www]\nuser = www-data\ngroup = www-data\nlisten = \/run\/php\/php8.0-fpm-xdebug.sock\nlisten.owner = www-data\nlisten.group = www-data\npm = dynamic\npm.max_children = 5\npm.start_servers = 1\npm.min_spare_servers = 1\npm.max_spare_servers = 3<\/code><\/pre>\n\n\n\nI think that’s it. Now it should just be a matter of<\/p>\n\n\n\n
systemctl daemon-reload\nsystemctl start php-fpm-xdebug\nsystemctl enable php-fpm-xdebug\nsystemctl reload apache2<\/code><\/pre>\n\n\n\nTo debug a web request, set a breakpoint, then in Run > Edit Configurations, create a “PHP Web Page” configuration. The URL you use here does not have to be the exact one you want to debug, it just has to be in the same cookie domain. Then Run > Debug… and select the configuration. This will spawn a browser tab which activates Xdebug with the XDEBUG_SESSION_START query string parameter. Xdebug modifies the response to set the XDEBUG_SESSION cookie.<\/p>\n\n\n\n
Since XDebug 3.1, the cookie has no expiry time set, but you can append XDEBUG_SESSION_STOP=1 to the query string to cause it to remove its session cookie. With no session cookie, you will automatically be back to PHP without Xdebug.<\/p>\n\n\n\n
You can get PHPStorm to run command-line scripts via SSH, but I find it’s most convenient to run them in the usual way, with the PHPStorm option “Listen for PHP Debug Connections” enabled.<\/p>\n\n\n\nI use a shell script wrapper along the lines of:<\/p>\n\n\n\n
XDEBUG_TRIGGER=1 PHP_IDE_CONFIG=serverName=test.internal \\\n php -dzend_extension=xdebug.so -dxdebug.mode=debug -dxdebug.client_port=9000 \\\n -dxdebug.client_host=169.254.1.1 \"$@\"<\/code><\/pre>\n\n\n\nThe serverName<\/code> configuration variable here is necessary to select the right path mappings \u00e2\u20ac\u201d it must correspond to the name of the server in PHPStorm’s File > Settings > PHP > Servers.<\/p>\n\n\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"
My MediaWiki test instance normally runs without Xdebug, since that gives good performance. But when I request a debug session in PHPStorm, Xdebug is automatically enabled. I don’t often share config snippets since they are so specific to the way I have things set up. You will most likely have to adapt this to your …<\/p>\n
Continue reading ‘Xdebug on demand’ »<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-207","post","type-post","status-publish","format-standard","hentry","category-web-development"],"_links":{"self":[{"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/posts\/207","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/comments?post=207"}],"version-history":[{"count":3,"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/posts\/207\/revisions"}],"predecessor-version":[{"id":214,"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/posts\/207\/revisions\/214"}],"wp:attachment":[{"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/media?parent=207"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/categories?post=207"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tstarling.com\/blog\/wp-json\/wp\/v2\/tags?post=207"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"\"](\"https:\/\/tstarling.com\/blog\/wp-content\/uploads\/2021\/10\/start-listening.png\")
<\/figure>\n\n\n\n