phpEnv下启用tidy扩展需确认php_tidy.dll存在、取消php.ini中;extension=php_tidy.dll的注释、确保extension_dir正确、重启服务，并验证php -m | findstr tidy；若失败，常因缺失libtidy.dll或PHP版本不兼容。
phpEnv 下默认不启用 tidy 扩展，必须手动开启配置并确认底层依赖可用，否则调用 tidy_parse_string 或 new tidy() 会直接报错 Class 'tidy' not found 或 Call to undefined function tidy_parse_string()。
phpEnv 中启用 tidy 扩展的实操步骤
phpEnv 是 Windows 下基于批处理封装的 PHP 环境管理工具，其扩展启用逻辑和原生 WAMP/XAMPP 类似，但路径和配置方式更隐蔽：
- 找到当前使用的 PHP 版本目录，例如
phpenv\versions\8.2.12\（版本号依实际而定） - 进入
ext\子目录，确认存在php_tidy.dll文件；若无，说明该 PHP 构建未编译 tidy 支持，需换版或自行编译 - 打开对应版本的
php.ini（通常在phpenv\versions\8.2.12\etc\php.ini），搜索;extension=php_tidy.dll，去掉前面的分号 - 确保
extension_dir指向正确的ext路径，例如extension_dir = "ext"（相对路径）或绝对路径 - 重启 phpEnv 的 Web 服务（如 Apache）或 CLI 环境，执行
php -m | findstr tidy验证是否加载成功
tidy_parse_string 和 tidy::parseString 行为差异
两者功能一致，但调用方式和错误处理不同，容易混淆导致静默失败：
-
tidy_parse_string()是函数式接口，返回tidy对象，失败时返回false，需手动检查 -
new tidy()+$tidy->parseString()是面向对象写法，parseString()失败不抛异常，但后续cleanRepair()可能无效 - 无论哪种方式，若输入为空字符串、编码指定错误（如写成
'UTF-8'而非'utf8'），parseString()都可能返回空对象且无提示 - 推荐统一用函数式写法，并加判断：
if (!$tidy = tidy_parse_string($html, $config, 'utf8')) { throw new RuntimeException('Tidy parse failed'); }
常见修复配置项的实际效果
tidy 的配置不是“开越多越好”，部分选项相互冲突或在特定场景下失效：
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
立即学习“PHP免费学习笔记（深入）”；
-
'clean' => true：启用基础标签修复（如自动闭合<p>、修正错位</div>），但不会删除 script/style 标签——这是安全设计，不是 bug -
'show-body-only' => true：只输出<body>内容，但若原始 HTML 根本没有<body>标签（比如纯片段），它会补一个空<body>并把全部内容塞进去，而非报错 -
'output-xhtml' => true：强制自闭合标签（<br />），但若原始含<svg>或 MathML，可能破坏命名空间，建议仅用于传统 HTML -
'wrap' => 0：禁用自动换行（避免长 URL 或代码被截断），wrap设为0或负数才真正关闭，设为200仍会折行
为什么 tidy_clean_repair() 有时没反应？
tidy_clean_repair() 是过程式函数，但它**只接受 tidy resource 类型参数**，不能传字符串或对象：
- 错误用法：
tidy_clean_repair($html_string)→ 无效果，返回null - 正确用法：
$tidy = tidy_parse_string($html); tidy_clean_repair($tidy); echo $tidy; - 注意：PHP 8.0+ 中
tidy对象已不再隐式转为字符串，必须显式调用(string)$tidy或$tidy->__toString()才能输出 HTML 内容 - 若要压缩 HTML（去空格/注释），得额外配
'hide-comments'=>true、'bare'=>true等，cleanRepair()本身不压缩
最易被忽略的是编码声明和 DLL 依赖：phpEnv 的 tidy 扩展依赖系统级 libtidy.dll，若该 DLL 缺失或版本不匹配（比如 PHP 8.2 需要 libtidy v5.8+），即使 php.ini 开了扩展，php -m 也看不到 tidy，且无任何错误日志——此时只能换用预编译好的完整包，或改用纯 PHP 实现的 HTML Tidy 替代方案。
