Xdebug 3 中 xdebug.profiler_output_name 已被移除，必须改用 xdebug.output_name 配合 xdebug.mode=profile 才生效；旧参数会被静默忽略，且仅支持 %t、%s、%r 等静态占位符。
Xdebug 3 的 xdebug.profiler_output_name 已被移除，不能再用它控制 profile 文件名 —— 必须改用 xdebug.output_name 配合 xdebug.mode=profile 才生效。
为什么改了 xdebug.profiler_output_name 却没效果
因为 Xdebug 3 彻底废弃了 xdebug.profiler_output_name（以及所有带 profiler_ 前缀的旧参数）。你如果还在 php.ini 里写这个，PHP 启动时会静默忽略，不会报错，但文件名始终是默认的 cachegrind.out.<pid></pid> 或 cachegrind.out.<timestamp></timestamp>。
- 检查是否误用了 Xdebug 2 的文档：Xdebug 2 支持
xdebug.profiler_output_name，但 Xdebug 3 不再识别 - 运行
php --ri xdebug，确认输出中没有 “profiler_output_name” 字样，只有 “output_name” - 若同时启用了
trace和profile模式，xdebug.output_name会统一控制两者文件名
xdebug.output_name 的合法占位符和典型用法
该参数只在 xdebug.mode=profile（或包含 profile）时起作用。支持的占位符有：
-
%t：Unix 时间戳（秒级，10 位数字），例如1745509824 -
%s：脚本 basename，不含路径和扩展名，例如index（对应/var/www/index.php） -
%r：随机字符串（12 位小写字母+数字），每次请求不同，防覆盖 -
%p：当前 PHP 进程 PID，Web 场景下不推荐——多进程下易冲突或难追踪 -
%u：微秒级时间戳（16 位），精度高但文件名过长，一般不用
推荐配置示例：
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
xdebug.mode=profile xdebug.start_with_request=trigger xdebug.output_name="cachegrind.%t.%s.%r"
访问 https://yoursite.test/?XDEBUG_PROFILE=1 后，生成类似 cachegrind.1745509824.index.abc123xyz789 的文件，可读性强、无冲突、便于按脚本归类。
文件名里想加 GET 参数？不行，但可以曲线实现
xdebug.output_name 不支持 %q（查询字符串）、%h（host）等动态 HTTP 上下文变量 —— 它只处理 PHP 进程启动时已知的静态信息。
- 若需区分不同请求参数（如
?id=123vs?id=456），只能靠外部逻辑：在触发前用file_put_contents()记录当前$_GET到同名.meta文件，人工关联 - 更实用的做法是：用
%s.%r组合保证单次请求唯一，再结合 PhpStorm 的「Call Tree」视图 + 「Inclusive Time」排序，直接定位到具体路由或 Action 级耗时 - 不要试图用
%p+ps aux | grep反查请求 URL —— Web Server 多进程模型下 PID 复用快，不可靠
生成文件名后找不到文件？先盯住 xdebug.output_dir 权限和路径
即使 xdebug.output_name 设置正确，若 xdebug.output_dir 不可写或路径不存在，Xdebug 会静默失败，连错误日志都不打（除非开了 xdebug.log）。
- 确保目录存在：
mkdir -p /tmp/xdebug && chown www-data:www-data /tmp/xdebug（Linux）或icacls "D:\xdebug" /grant "IIS_IUSRS:(OI)(CI)F"（Windows IIS） - 路径别用相对路径如
./xdebug：CLI 和 Web 请求工作目录不同，极易写错位置；统一用绝对路径，如/var/www/myapp/xdebug - 验证是否真写了：在页面加一行
file_put_contents('/tmp/xdebug/test.txt', 'ok');，看能否成功 —— 这比猜配置快得多
最常被忽略的是：xdebug.output_name 生效的前提是整个 profiling 链路跑通。文件名再漂亮，卡在权限或触发条件上，照样空目录。
