DDEV
-
BackgroundBefore asking this question, I searched through existing issues/PRs and reviewed the official documentation “Step Debugging with Xdebug”. I can already debug regular web requests without any issues. SetupI prepared a reproducible example based on Laravel 12 and the default DDEV database. In web_extra_daemons:
- name: "queue-2"
command: "/usr/bin/php /var/www/html/artisan queue:listen --sleep=3 --tries=3 --timeout=120"
directory: /var/www/htmlThen, using Current StatusAfter enabling Xdebug via 
ProblemWhen supervisor-managed queue workers run, PhpStorm shows:
Queue breakpoints are not hit. I am certain that passing the correct server name (for example, Is there a better or more standard way to enable Xdebug for Laravel queue workers run under supervisor? Thank you. |
Beta Was this translation helpful? Give feedback.
Replies: 1 comment 14 replies
-
|
Hi @faytecCD,
There are some conflicts with
Not a direct solution, but I usually use Buggregator for cases like this (for example, when I need to debug an API call coming from another DDEV project). Setting up Xdebug for these extended workflows is always tricky. |
Beta Was this translation helpful? Give feedback.
-
|
Mostly this is a question that would be better asked (or asked in addition) in places like the Xdebug queue, or on Stack Overflow. Xdebug also has (or will have) the ability to connect to a running process for debugging; this was discussed in Drupalcon Vienna presentation on Xdebug by its founder, @derickr. |
Beta Was this translation helpful? Give feedback.
-
|
Hi, @stasadev , thank you for your reply. Yes. I saw that #3149 PR yesterday. I also noticed several other entries related to I used Sail before, and it provides a So I think I may need to customize some commands: when enabling debug mode, append I believe this will help me use it more effectively. I have not used Therefore, I still prefer step-by-step debugging with Xdebug, as it helps me understand the code execution more deeply. |
Beta Was this translation helpful? Give feedback.
-
|
@faytecCD If you want to see the Xdebug queue working attachment in action: https://www.youtube.com/watch?v=jBvrVpNHOCw |
Beta Was this translation helpful? Give feedback.
-
|
I have now removed the environment=PHP_IDE_CONFIG="serverName=%(ENV_DDEV_SITENAME)s.%(ENV_DDEV_TLD)s" |
Beta Was this translation helpful? Give feedback.
-
|
@rfay @derickr Thank you for letting me know about this Xdebug feature. After watching the video, it looks great. However. I noticed that in Bugs #2219 , it mentioned:
Is this still the case now? Can it work well with Docker? (This seems to have strayed from the discussion of this topic; I just want to add something.) I am running on a MacBook with an Apple M2. Inside ddev’s web container, I performed the following steps to generate the binary files: ddev ssh # enter web container
cd ~
git clone https://github.com/derickr/dbgp-tools.git
cd xdebug
sudo apt update
sudo apt install build-essential golang
makeThis generated several
<?php
declare(strict_types=1);
function doSome()
{
echo mt_rand().PHP_EOL;
}
while (true) {
doSome();
usleep((int)1e6);
}
ddev xdebug
ddev ssh # enter web container
php loop.php # in web container (no XDEBUG_TRIGGER needed, breakpoints work correctly)
ddev ssh # enter web container
./xdebug-arm64 ps # in web containerHowever, it produced no output. Then I checked the source code of I manually ran ChatGPT then referred me to this link: https://bugs.xdebug.org/view.php?id=2219, which mentions an
it still remained But I couldn’t find documentation for Did I miss something? Or is this feature currently not usable inside containers? Thank you for the excellent work. Some potentially helpful information is shown below ⬇️ More |
Beta Was this translation helpful? Give feedback.
-
That's surprising, as they are for non-compatible architectures.
Did you do that in the container?
It accepts The default should be Unless during the Also see that What OS do you run inside the docker container? Control sockets are Linux/Windows (from 3.5) only. |
Beta Was this translation helpful? Give feedback.
-
|
Thank you, sir. I just tried
$ php -d "xdebug.control_socket=default" --ri xdebug | grep control
xdebug.control_socket => off => off
$ php -d "xdebug.control_socket=time" --ri xdebug | grep control
xdebug.control_socket => time: 100ms => time: 100ms
$ php -d "xdebug.control_socket=time" loop.php
# Loop running
$ ./xdebug-arm64 ps
PID RSS TIME COMMAND
95742 369 220.51 /var/www/html/loop.php (Xdebug3.4.5)
$ ./xdebug-arm64 ps
PID RSS TIME COMMAND
95742 Error: No response on: @xdebug-ctrl.95742yxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
$ ./xdebug-arm64 ps
PID RSS TIME COMMAND
95742 369 224.51 /var/www/html/loop.php (Xdebug3.4.5)As shown, I occasionally get different output, especially when sending the pause command: $ ./xdebug-arm64 pause
601 Error: No response on: @xdebug-ctrl.601yxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxAfter the command is executed, PHP pauses immediately, but PHPStorm takes a few seconds to respond. I recorded a video and played it at 2× speed. My setupPHPStorm is running on macOS.
This is very cool.
My guess is that this may be related to macOS Rosetta 2.
Yes, inside the container. I assumed it would be more closely related to the Xdebug runtime, so I ran PS: PHPStorm is running on macOS. Below is information from the container: $ uname -a
Linux project-laravel-web 6.10.14-linuxkit #1 SMP Tue Oct 14 07:32:13 UTC 2025 aarch64 GNU/Linux
$ lsb_release -a
No LSB modules are available.
Distributor ID: Debian
Description: Debian GNU/Linux 12 (bookworm)
Release: 12
Codename: bookwormI noticed in PR #965 that if I can see
Thank you, and sorry. I couldn’t find documentation before, and the only thing I saw online was a configuration in a FrankenPHP issue, so I guessed Later I will try the same test with PHPStorm on Windows to compare results. But I noticed that Xdebug 3.5.0alpha2 on GitHub already includes support for Windows, while dbgp-tools/xdebug still doesn’t seem to support Windows. What should I use to trigger a pause on Windows? Thanks a lot for your help! |
Beta Was this translation helpful? Give feedback.
@faytecCD If you want to see the Xdebug queue working attachment in action: https://www.youtube.com/watch?v=jBvrVpNHOCw