xdebug profiling 默认关闭且不可用 ini_set() 动态开启，必须在 php.ini 中配置 xdebug.profiler_enable=1 或更安全的 xdebug.profiler_enable_trigger=1，并确保输出目录存在、有写权限且路径为绝对路径。

Xdebug profiling 默认是关闭的，必须显式启用，且不能用 ini_set() 动态开启 —— 这是最常踩的坑。

为什么 xdebug.profiler_enable=1 没生效？

因为这个配置项只在 PHP 启动时读取（属于 Zend 扩展初始化阶段），运行时调用 ini_set('xdebug.profiler_enable', '1') 完全无效。常见错误现象：代码里写了 ini_set，但 /var/tmp 或指定目录下始终没生成 cachegrind.out.* 文件。

• 确认你改的是实际被加载的 php.ini（用 php --ini 查 CLI 配置，phpinfo() 查 Web SAPI 配置）
• Windows 下必须用 zend_extension=（不是 extension=），路径含空格要加英文双引号
• Linux/macOS 下确保 .so 文件权限可读，且路径与 php -m 显示的扩展路径一致
• 修改后必须重启 PHP-FPM / Apache / Nginx，仅刷新页面无效

xdebug.profiler_enable vs xdebug.profiler_enable_trigger

直接设 xdebug.profiler_enable=1 会让每次请求都生成分析文件，对生产或高并发环境极不友好 —— 文件爆炸、I/O 拖慢响应、磁盘占满。

Xdebug 3.4.1

Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有

下载

• xdebug.profiler_enable=1：全局强制开启，适合本地单次压测
• xdebug.profiler_enable_trigger=1 + 请求带 XDEBUG_PROFILE 参数（如 ?XDEBUG_PROFILE）：按需触发，安全可控
• 两者互斥，建议只开后者；若同时为 1，trigger 优先级更高

输出目录和文件名怎么配才不丢文件？

路径不存在、无写入权限、或被 SELinux/Windows 权限拦截，都会导致静默失败 —— 看不到报错，也看不到文件。

• xdebug.profiler_output_dir 必须是绝对路径，且 PHP 进程用户（如 www-data、_www 或你的当前用户）有写权限
• xdebug.profiler_output_name 推荐用 cachegrind.out.%t.%p：%t 是时间戳，%p 是进程 ID，避免并发覆盖
• 不要设成 /tmp（某些系统会定期清理）；macOS 上 /var/tmp 更稳妥；Windows 建议用 C:\temp\xdebug 并提前建好目录

真正麻烦的不是配参数，而是确认 PHP 进程到底有没有权限往那个目录里写 —— 很多时候配置全对，就卡在这一步。