You can use RoadRunner scripts with xDebug extension. In order to enable configure your IDE to accept remote connections.

If you run multiple PHP processes you have to extend the maximum number of allowed connections to the number of active workers, otherwise some calls would not be caught on your breakpoints.

To activate xDebug make sure to set the xdebug.mode=debug in your php.ini.

To enable xDebug in your application make sure to set ENV variable XDEBUG_SESSION:

   listen: tcp://

   command: "php worker.php"

   address: ""
      num_workers: 1
      debug: true

Please, keep in mind this guide: xdebug3.

You should be able to use breakpoints and view state at this point.

PhpStorm notes

export PHP_IDE_CONFIG="serverName=octane-app.test"
export XDEBUG_SESSION="mode=debug start_with_request=yes client_host= client_port=9003 idekey=PHPSTORM"

php -dvariables_order=EGPCS artisan octane:start --max-requests=250 --server=roadrunner --port=8000 --rpc-port=6001 --watch --workers=1

Feel free to check our community notes: link

Jobs debugging


  1. XDebug 3 installed and properly configured.

  2. Number of jobs workers set to 1 with jobs.pool.num_workers configuration option in .rr.yaml.

Debug process

If you have any active XDebug listener while starting RoadRunner with XDebug enabled β€” disable it. This will prevent false-positive debug session.

Once RoadRunner starts all workers, enable XDebug listener and reset jobs workers with:

./rr reset jobs

Now you should see debug session started:

  1. Step over to some place where job task is being resolved with $consumer->waitTask().

  2. As soon as you reach it, debugger stops but session will still be active.

  3. Trigger task consumption with either an HTTP request or a console command (depending on how your application works). and continue to debug job worker as usual within active session started before.

  4. You can continue to debug jobs as long as debug session active.

If connections session broken or timed out, you can repeat instruction above to reestablish connection by resetting jobs workers.

Last updated