修改xdebug.profiler_output_name后文件名不变，根本原因是xdebug.profiler_enable必须在php.ini中静态设为1且重启web服务器或php-fpm，动态开启无效；该配置仅在profiler启用时生效，且支持的占位符仅有%c、%p、%r、%s、%t、%u，其他如%y会被原样保留导致失败。
为什么修改xdebug.profiler_output_name后文件名没变
常见现象是改了配置但生成的 cachegrind 文件还是叫 cachegrind.out.%p，或者始终固定一个名字。根本原因是：该配置只在 profiler 启用时生效，而 xdebug.profiler_enable 必须为 1（或 On），且不能用 ini_set() 动态开启——它只能在 php.ini 里静态启用。
另外，PHP 进程启动后才读取该配置，所以改完必须重启 Web 服务器（如 Apache）或 PHP-FPM，单纯 reload 不生效。
-
xdebug.profiler_enable = 1是硬性前提，缺一不可 - 若使用
xdebug.profiler_enable_trigger = 1，则需手动带XDEBUG_PROFILE参数访问 URL，此时xdebug.profiler_output_name才起作用 - Windows 下路径分隔符不影响该配置，但输出目录（
xdebug.profiler_output_dir）必须真实存在且有写权限
xdebug.profiler_output_name支持哪些占位符
这个配置控制 cachegrind 文件的命名模板，支持一组内置变量替换，不是正则也不是任意字符串。常用且稳定的占位符只有这几个：
-
%c：当前工作目录的 CRC32 校验值（不推荐，难定位） -
%p：当前 PHP 进程 PID（最常用，默认值就含它） -
%r：随机数（每次请求不同，适合并发调试） -
%s：脚本文件名（不含路径和扩展名），例如index来自index.php -
%t：Unix 时间戳（秒级，精确到秒） -
%u：微秒级时间戳（精确到微秒，文件名会很长）
错误示例：xdebug.profiler_output_name = "profile-%Y%m%d.log" 中的 %Y 不被识别，会被原样保留，导致文件名出现非法字符或写入失败。
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
推荐的命名组合及适用场景
单一占位符太难区分，组合使用才能快速归因。以下几种是经实测稳定、易排查的写法：
-
xdebug.profiler_output_name = "cachegrind.out.%t.%s"：按时间+脚本名区分，适合单次压测或 CLI 脚本分析 -
xdebug.profiler_output_name = "cachegrind.out.%t.%r"：时间+随机数，避免并发覆盖，适合高并发 Web 请求 -
xdebug.profiler_output_name = "cachegrind.out.%s.%p"：脚本名+PID，适合本地开发时反复刷新调试 - 慎用
%c：目录变化时 CRC 值突变，容易误以为是新请求，实际可能是同一入口不同子目录
注意：%s 在 CLI 模式下可能为空（因为无“脚本名”概念），此时建议搭配 %t 或 %r 使用。
文件名过长或写入失败的隐藏原因
看起来配置对了，但目录里始终没生成文件，或生成空文件，往往卡在这几个细节：
- Windows 下文件名总长度超过 260 字符（如用了
%u+ 长路径 + 多个占位符），会静默失败 -
xdebug.profiler_output_dir目录不存在，或 PHP 进程用户无写权限（尤其在 Docker 或 Nginx + PHP-FPM 分离部署时） - 启用了
xdebug.profiler_append = 1，但多个请求共用一个文件名，导致内容被覆盖而非追加（该选项实际不推荐开启） - PHP 错误日志中可能出现
Failed to write Xdebug profile file，但默认不显示，需检查error_log配置路径
最稳妥的做法：先用 %t.%s 组合，确认能生成文件；再逐步加字段，每次改完都清空目标目录并观察是否稳定产出。
