0002399: Create `xdebug_add_source_map_directory` to dynamically add directories where Xdebug will load path mapping files from

ID	Project	Category	View Status	Date Submitted	Last Update
0002399	Xdebug	Path Mapping	public	2026-01-15 12:53	2026-01-15 12:54

Reporter	derick	Assigned To
Priority	normal	Severity	feature	Reproducibility	have not tried
Status	new	Resolution	open
Target Version	3.6dev

Summary	0002399: Create `xdebug_add_source_map_directory` to dynamically add directories where Xdebug will load path mapping files from
Description	Sometimes, a templating system would like to put mapping files in its own cache/compiled_templates directory, and not necessarily in the `.xdebug` in the root of the project. Add the `xdebug_add_source_map_directory` function to add and load new files from the specified directory — when called. The function must also look at already existing breakpoints, and rewrite them with the new file/line for this to be effective. This ticket comes forth out of https://github.com/twigphp/Twig/pull/4733#pullrequestreview-3654648341
Tags	No tags attached.

Operating System
PHP Version	8.5.0-8.5.4

Date Modified	Username	Field	Change
2026-01-15 12:53	derick	New Issue
2026-01-15 12:54	derick	Description Updated