CentOS环境下xdebug3如何在xdebug.ini中配置排除auto_prepend_file加载文件

问题解决方案 #

Xdebug 3 完全支持在INI配置文件（包括你单独管理的xdebug.ini）中配置路径排除规则，不存在你担心的先加载文件还是先排除的时序问题：Xdebug的INI配置是PHP进程启动、扩展初始化阶段就加载完成的，时序远早于任何PHP文件（包括auto_prepend_file指定的前置文件）的执行。

具体配置步骤

• 编辑你的xdebug.ini配置文件，添加如下配置项，填入umask.php在服务器上的绝对路径：

  xdebug.path_exclude = /absolute/path/to/umask.php
  

• 如果你需要同时排除多个路径，用英文逗号分隔即可：

  xdebug.path_exclude = /path/umask.php,/path/other/excluded/dir/
  

• 配置完成后重启php-fpm（或对应web服务的PHP进程），执行命令php -i | grep xdebug.path_exclude即可验证配置是否生效。

补充说明

你之前了解到的XDEBUG_PATH_EXCLUDE是运行时环境变量，作用是覆盖INI配置，优先级更高，但INI层面的xdebug.path_exclude配置是Xdebug 3原生支持的正式配置项，不存在缺失的情况。
配置生效后，Xdebug会在服务端直接匹配排除指定路径的文件，不会触发断点、也不会向本地调试客户端发送对应文件的调试信息，自然就不会出现无路径映射的报错问题。

内容的提问来源于stack exchange，提问作者Tomasnorre