phpEnv配置PHP tidy扩展教程

本文详细讲解了在 Windows 平台绿色集成环境 phpEnv 中启用 PHP tidy 扩展的完整实操流程：从取消 php.ini 中 extension=php_tidy.dll 的注释、确认 ext/ 目录下存在对应 DLL 文件，到解决因缺失系统级 tidy.dll 导致的“Call to undefined function”运行时错误——需手动下载官方 tidy-html5 的 win64 版本并部署 tidy.dll 至 PHP 根目录或 PATH；同时特别提醒关闭危险的 tidy.clean_output = On 默认配置，避免非 HTML 输出被意外污染，并强调所有修改后必须重载服务才能生效。这是一份直击痛点、步骤清晰、覆盖常见陷阱的实战指南，助你快速让 tidy 功能真正可用。

phpEnv 里 tidy 扩展默认不启用，必须手动开启

phpEnv 是 Windows 平台的绿色集成环境，它预装了多个 PHP 版本，但 tidy 扩展默认处于注释状态（即未加载）。你打开任意一个版本的 php.ini（路径类似 D:\phpEnv\php\php-8.2.12\php.ini），搜索 tidy，大概率会看到这一行：

;extension=php_tidy.dll

。这不是“已安装”，只是“已打包但未启用”。

确认 tidy.dll 存在且路径正确

phpEnv 的每个 PHP 版本目录下都有 ext\ 子目录。进到对应版本（比如 php-8.2.12\ext\），检查是否存在 php_tidy.dll。如果不存在，说明该版本编译时没带 tidy 支持 —— 这种情况在 phpEnv 8.11.0+ 的 8.3/8.4 版本中较常见，因为 tidy 依赖系统级 libtidy 动态库，而 Windows 版 phpEnv 没有自带或自动链接它。

• 若存在 php_tidy.dll：取消 php.ini 中对应行的分号，保存
• 若不存在：不能靠自己编译；需降级使用 8.2.x 或 8.1.x 等明确包含 tidy 的版本，或改用 WSL + phpenv 方案
• 启用后务必检查 extension_dir 指向是否正确，例如：extension_dir = "ext"（相对路径）或 extension_dir = "D:\phpEnv\php\php-8.2.12\ext"（绝对路径）

启用后仍报“Call to undefined function tidy_parse_string()”

这是最常见的运行时错误，根本原因不是扩展没加载，而是 libtidy 运行时 DLL 缺失。Windows 下 php_tidy.dll 是个壳，真正干活的是外部的 tidy.dll（注意没有 php_ 前缀）。phpEnv 不自带这个文件，也不自动把它放进 PATH。

• 去 tidy-html5 官方 GitHub Releases 下载最新 win64.zip 包
• 解压后找到 bin\tidy.dll，复制到 PHP 目录根下（如 D:\phpEnv\php\php-8.2.12\tidy.dll）
• 或者更稳妥：把整个 bin\ 目录加进系统 PATH，重启 phpEnv 控制台
• 验证方式：在命令行执行 php -m | findstr tidy，应输出 tidy；再运行 php -r "var_dump(function_exists('tidy_parse_string'));"，返回 bool(true)

tidy.clean_output = On 在 phpEnv 中要特别小心

这个 INI 配置项在 phpEnv 的 php.ini 里常被默认设为 On，但它会在所有响应输出前自动调用 tidy 修复 HTML —— 对 JSON、图片、二进制流等非 HTML 内容是灾难性的，会导致头部污染、格式错乱甚至 500 错误。

• 除非你确定整个站点只输出 HTML，否则建议显式设为 Off：

  tidy.clean_output = Off

• 需要修复 HTML 时，用代码控制更安全，例如：

  $tidy = tidy_parse_string($html, ['output-xhtml'=>1], 'utf8'); tidy_clean_repair($tidy); echo tidy_get_output($tidy);

• phpEnv 的“站点配置”界面不暴露 tidy 相关选项，所有调整必须直接改 php.ini

实际生效前记得在 phpEnv 主界面点「重载配置」或重启 Apache/Nginx 服务。tidy 的 DLL 依赖链（php_tidy.dll → tidy.dll）断裂比扩展未启用更难排查，优先盯住 tidy.dll 文件是否存在、是否能被 PHP 进程读取。

以上就是《phpEnv配置PHP tidy扩展教程》的详细内容，更多关于phpenv的资料请关注golang学习网公众号！