xdebug.profiler_enable在Xdebug 3中已被移除，必须改用xdebug.mode=profile配合xdebug.start_with_request=trigger及XDEBUG_PROFILE参数触发；仅设mode不生效，还需xdebug.output_dir可写且配置合理。
xdebug.profiler_enable 已被移除，改用 xdebug.mode=profile
xdebug.profiler_enable 在 Xdebug 3 中彻底废弃，不再识别。它被统一收归到 xdebug.mode 这个主开关下——所有功能（debug、profile、trace、develop）都通过这个单一配置项组合启用。
如果你之前靠 xdebug.profiler_enable=1 开启性能分析，现在必须改成：
xdebug.mode = profile
常见错误现象：
- PHP 启动时报 Warning：
Unknown configuration setting 'xdebug.profiler_enable' - 即使写了
xdebug.output_dir，也没有生成cachegrind.out.*文件 -
phpinfo()中看不到 profiler 相关状态为 enabled
使用场景：
- 本地开发时临时分析某次请求的耗时瓶颈
- 配合 WebGrind 或 KCacheGrind 查看函数调用树
- CI/CD 流程中对关键脚本做轻量级性能快照（需搭配触发机制）
参数差异：
-
xdebug.mode=profile是“全局模式开关”，不带条件；而旧版xdebug.profiler_enable本身也不带条件，但容易和xdebug.profiler_enable_trigger混用导致逻辑混乱 - 真正替代“按需启用”的是
xdebug.start_with_request=trigger+ 请求参数XDEBUG_TRIGGER=PROFILING，不是靠xdebug.mode动态变 - 若同时需要调试和性能分析，写成
xdebug.mode=debug,profile即可，无需多行
必须配齐的配套参数才能生成 cachegrind 文件
只设 xdebug.mode=profile 不够，Xdebug 3 默认不会自动写文件——它还依赖 xdebug.output_dir 和触发策略。
Xdebug 3.4.1
下载
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
实操建议：
- 确保
xdebug.output_dir存在且 PHP 进程有写权限（如/tmp/xdebug） - 推荐显式设置
xdebug.profiler_output_name=cachegrind.out.%p，避免默认名含时间戳导致难以定位 - 生产-like 环境务必用
xdebug.start_with_request=trigger，否则每次请求都写文件，磁盘和 I/O 压力会陡增 - 如果用 Docker，
xdebug.output_dir要映射到宿主机可读路径，否则容器里生成了你也拿不到
典型有效配置段：
[xdebug] zend_extension=xdebug.so xdebug.mode=profile xdebug.output_dir=/tmp/xdebug xdebug.profiler_output_name=cachegrind.out.%p xdebug.start_with_request=trigger
为什么不能只靠 xdebug.mode=profile 就跑起来
因为 Xdebug 3 的设计哲学是“默认关闭一切高开销功能”。xdebug.mode=profile 只表示“允许 profile 功能被激活”，但是否真启动，取决于 xdebug.start_with_request 的值和实际请求上下文。
容易踩的坑：
- 设了
xdebug.mode=profile但忘了xdebug.start_with_request，结果始终不生成文件 - 设了
xdebug.start_with_request=yes，导致每秒数百请求全写 cachegrind，/tmp快速占满 - 没检查
xdebug.output_dir权限，PHP 报错沉默失败（日志里才见Failed to open stream） - 误以为
xdebug.mode=profile自带触发逻辑，其实它和XDEBUG_TRIGGER参数无关——那是debug模式用的；profile 模式对应的是XDEBUG_PROFILE参数（注意拼写）
验证是否生效最直接的方式：
- 发起请求：
curl "http://localhost/test.php?XDEBUG_PROFILE=1" - 检查
/tmp/xdebug/下是否出现cachegrind.out.* - 用
file cachegrind.out.*确认是文本格式，不是空文件或二进制乱码
复杂点在于：profile 和 debug 共享同一套触发机制但参数名不同，XDEBUG_TRIGGER 控 debug，XDEBUG_PROFILE 控 profile，这点极易混淆，而且文档里藏得深。
