不能用 phpEnv 命令一键安装 Xhprof；必须手动编译适配当前 PHP 版本、架构（x64/x86）、NTS/TS 和 VC 版本的 php_xhprof.dll，并配置对应 php.ini。
phpEnv 是一个 Windows 下的 PHP 多版本环境管理工具（类似 macOS 的 phpenv 或 Linux 的 phpbrew），但它本身不内置或直接支持 Xhprof 扩展安装。Xhprof 是 C 编写的 PHP 扩展，需手动编译适配对应 PHP 版本、架构（x86/x64）、线程安全（TS/NTS）和 ZTS 模式 —— 而 phpEnv 提供的预编译 PHP 二进制包通常不含 xhprof.so。
所以结论很明确：不能用 phpEnv 命令一键安装 Xhprof；必须手动编译扩展，并确保与当前 phpEnv 激活的 PHP 版本完全匹配。
phpEnv 下 Xhprof 编译失败的常见原因
-
phpEnv默认使用 NTS（非线程安全）+ VC15/VC17 编译的 PHP，但你下载的xhprof.so可能是 TS 版或旧 VC 编译，加载时直接报PHP Warning: PHP Startup: Unable to load dynamic library 'xhprof.so' -
phpize路径混乱：你运行的是系统全局的phpize，而非phpEnv当前版本附带的phpize.exe，导致生成的 configure 脚本指向错误的头文件和 API 版本 - 缺少 Visual Studio 构建工具（如 VS2019 Build Tools），
nmake报错或找不到cl.exe -
php.ini加载顺序问题：phpEnv通常在%USERPROFILE%.phpenv\versions\<version>\etc\php.ini</version>，但 CLI 和 Web SAPI 可能读取不同配置（比如 Apache 用的是另一份）
怎么让 Xhprof 在 phpEnv 中真正跑起来
-
确认当前激活的 PHP 版本和构建信息：
php -v
php --ri xhprof
（如果已加载，会显示版本；否则说明没生效）php -i | findstr "Thread Safety Architecture"
→ 必须看到Thread Safety => disabled（NTS）和x64或x86，与你要编译的目标一致 -
使用
phpEnv自带的phpize（关键！）：立即学习“PHP免费学习笔记（深入）”；
%USERPROFILE%\.phpenv\versions\{your-version}\bin\phpize.bat不要用C:\php\phpize或全局 PATH 里的，否则头文件路径错乱 -
下载兼容源码（别用 PECL 官方老版）： GitHub 上维护较新的分支如
longxinH/xhprof支持 PHP 7.2–8.1，且含 Windows 构建脚本（build.bat）。直接克隆：git clone https://github.com/longxinH/xhprof
-
编译前改两处关键代码（否则 Windows 下必挂）：
- 修改
xhprof/extension/xhprof.c第 35 行：把#include "main/php_streams.h"改成#include "main/php_streams.h"（这行通常没问题，但某些版本需补全路径） - 修改
xhprof/extension/config.w32，确认ADD_EXTENSION('xhprof', 'xhprof.c');存在，且没有条件排除 Windows
- 修改
-
运行构建（以 PHP 8.0 NTS x64 为例）：
cd xhprof\extension
%USERPROFILE%\.phpenv\versions\8.0\bin\phpize.bat
configure --enable-xhprof --with-php-config=%USERPROFILE%\.phpenv\versions\8.0\bin\php-config.bat
nmake
成功后会在Release\php_xhprof.dll（不是.so）生成动态库 -
配置
php.ini（只改phpEnv当前版本的那份）：extension=php_xhprof.dll
xhprof.output_dir=C:\tmp\xhprof
注意路径用反斜杠或双斜杠，且C:\tmp\xhprof目录必须存在、PHP 进程有写权限 Web 端查看需部署
xhprof_html： 把xhprof/xhprof_html整个目录放到你的 Web 根目录（如XAMPP\htdocs\xhprof_html），并确保config.php中的$XHPROF_ROOT指向正确的xhprof_lib路径（不要用相对路径，用绝对路径如C:/phpenv/xhprof）
Xhprof 数据无法在 xhprof_html 中显示的典型卡点
-
xhprof.output_dir设置了，但 PHP 进程（尤其是 Apache 的 httpd.exe）无权写入该目录 → 改用C:\tmp\xhprof并右键目录 → 属性 → 安全 → 给IIS_IUSRS或Everyone写入权限（仅开发机） -
xhprof_runs.php里默认用file_get_contents读取.xhprof文件，但 Windows 下路径分隔符处理异常 → 确保保存时用$xhprof_runs->save_run($data, 'test')，且文件名不含非法字符（空格、中文、冒号） -
index.php报Fatal error: Class 'XHProfRuns_Default' not found→ 检查config.php中require_once的xhprof_lib.php路径是否真实存在，且大小写完全匹配（Windows 不敏感但 PHP include 有时会因大小写出错）
Xhprof 在 phpEnv 下最难的从来不是“装上”，而是 DLL 编译时与当前 PHP 的 ABI 兼容性 —— 即便所有步骤都对，换一个 minor 版本（如 8.0.28 → 8.0.30）也可能需要重编。建议编译成功后把 php_xhprof.dll 和对应 php.ini 配置项一起存档，避免反复踩坑。
