phpenv 中 tidy 扩展需手动启用:取消 php.ini 中 ;extension=php_tidy.dll 的注释,确认 ext/ 下存在该文件;若缺失则需降级版本或改用 wsl;还需下载官方 tidy.dll 放入 php 根目录或添加其路径到系统 path,并关闭 tidy.clean_output = on 以防输出污染。

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 没有自带或自动链接它。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 若存在
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
tidy.dll 文件是否存在、是否能被 PHP 进程读取。php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










