0002373: Add built-in support for Step Filters while debugging

ID	Project	Category	View Status	Date Submitted	Last Update

0002373	Xdebug	Step Debugging	public	2025-10-09 07:20	2025-11-06 16:26

Reporter	slam	Assigned To	derick
Priority	normal	Severity	feature	Reproducibility	always
Status	feedback	Resolution	open

Summary	0002373: Add built-in support for Step Filters while debugging
Description	Hello, I've seen your video on Youtube "Xdebug 3: Skipping Files when Debugging" and also read the documentation on PHPStorm on how to skip files and folders while step debugging, but unfortunately I've not been able to make it work on any of my setup. After a research on Jetbrains' bug tracker, I've found I'm not alone: https://youtrack.jetbrains.com/issues/WI?q=step%20filters Many deveopers have issues on this very topic, and the variety and heterogeneity of tools and environments make it tough for PHPStorm to keep this feature working easily. Would it be possible to add a configuration to directly instruct xDebug to ignore paths with a directive, something like `xdebug.step_debug_ignore_paths="./vendor/"`? Thank you for this precious tool, best regards
Tags	debug, PHPStorm

Operating System
PHP Version	8.3.10-8.3.19

derick 2025-10-22 08:53 administrator ~0007363 Last edited: 2025-10-22 08:54	I am currently not interested in adding more ini settings for this. I am also wondering why you couldn't make it work, as all it requires would be to drop the following file in the root of your project as '`.xdebug/skip-vendor.map`: `./vendor/ = SKIP` Mind you, this functionality hasn't been released, and is only available in the 3.5.0alpha2 release. The Skip Filters in PhpStorm are a very different feature, about which Xdebug knows nothing. They are not two features working together. When you use this, can you show the xdebug.log file set with xdebug.log_level=10 ?

slam 2025-10-27 14:29 reporter ~0007379	As a web server I'm using FrankenPHP in Classic mode. I've created the file: $ cat .xdebug/vendor.map ./vendor/ = SKIP Restarted the entire docker stack, but still I step into vendor's files instead of skipping them. I've attached the log_level=10 output. I can't see that the map file has been read, somewhere in the `php -i` output, can I? xdebug.txt (301,348 bytes)

slam 2025-10-27 14:30 reporter ~0007380	Forgot to mention: new feature tried at xdebug/xdebug@bd9f063cc6a5c42bbd7f41fdbe5cad7b6f5f8fde

derick 2025-11-06 16:26 administrator ~0007397	Did you turn on path mapping with the `xdebug.path_mapping=1` setting in php.ini?

Date Modified	Username	Field	Change
2025-10-09 07:20	slam	New Issue
2025-10-09 07:20	slam	Tag Attached: debug
2025-10-09 07:20	slam	Tag Attached: PHPStorm
2025-10-22 08:53	derick	Assigned To	=> derick
2025-10-22 08:53	derick	Status	new => feedback
2025-10-22 08:53	derick	Note Added: 0007363
2025-10-22 08:54	derick	Note Edited: 0007363
2025-10-27 14:29	slam	Note Added: 0007379
2025-10-27 14:29	slam	File Added: xdebug.txt
2025-10-27 14:29	slam	Status	feedback => assigned
2025-10-27 14:30	slam	Note Added: 0007380
2025-11-06 16:26	derick	Status	assigned => feedback
2025-11-06 16:26	derick	Note Added: 0007397