2025-10-07
Xdebug 3.5.0alpha2 is out!
This is a preview release of Xdebug 3.5, also containing support for PHP 8.5.
The biggest new feature is the Native Path Mapping in the step debugger. This which makes it possible for projects and developers to create mapping definitions that maps files in directories, individual files, and even line ranges in files, that are being run, to files that you would edit. This is useful for generated files, compiled templates files, etc.
Path mapping also allows you to define directories, files, and lines in
files to skip. This makes it possible to exclude for example
vendor/ directories etc. You can read more about this on the
dedicated Project
Page, but please be aware that not everything has been implemented yet.
You can see path mapping and skipping in action, in a few teaser videos that I have produced:
Beyond Native Path Mapping, this release also adds experimental support for Windows Named Pipes control sockets, exposes the value of the current exception in a pseudo variable while debugging. There are also several bug fixes and performance improvements.
The full list of changes can be found on the updates page.
The source code can be found on the downloads page, and as usual, Xdebug is installable through PECL and PIE, and is also available as package for most Linux distributions.
If you find a bug, please file a report at Xdebug's Issue Tracker.
This release also contains contributions by: Carlos Granados, Damjan Cvetko, Jesper Noordsij, and Shivam Mathur — Thanks!