phpEnv怎么开启Tidy扩展 phpEnv修复HTML代码方法-php教程-PHP中文网

phpenv 不内置 tidy 扩展，需手动确认 dll 存在、启用 extension=php_tidy.dll、重启服务并验证；启用后优先用 tidy_repair_string() 显式修复 html，注意输入校验、编码一致性和 xss 防护。

phpenv怎么开启tidy扩展 phpenv修复html代码方法

phpEnv 本身不内置 tidy 扩展，必须手动启用 —— 否则调用 tidy_parse_string() 或实例化 Tidy 类会直接报 Fatal error: Uncaught Error: Class "Tidy" not found。

确认 phpEnv 当前 PHP 版本是否支持 tidy

phpEnv 是 Windows 下的多版本 PHP 环境管理工具，它依赖你安装的每个 PHP 版本自身是否编译了 tidy 扩展。不是所有预编译的 PHP 二进制包都默认开启该扩展：

打开 phpEnv 控制面板 → 查看当前激活的 PHP 版本（如 php-8.2.12-nts-VS17-x64）
在对应 PHP 安装目录下检查：ext\php_tidy.dll 是否存在（路径类似 C:\phpEnv\php\php-8.2.12-nts-VS17-x64\ext\php_tidy.dll）
若不存在，说明该版本未打包 tidy，需换用带 tidy 的 PHP 构建版，或自行编译（极不推荐）

在 phpEnv 中启用 tidy 扩展（Windows）

即使 php_tidy.dll 存在，也需显式启用。phpEnv 的配置文件实际指向各 PHP 版本独立的 php.ini：

用 phpEnv 面板点击「编辑 php.ini」，或手动打开对应版本的 php.ini（如 C:\phpEnv\php\php-8.2.12-nts-VS17-x64\php.ini）
搜索 ;extension=php_tidy.dll，去掉前面的分号，改为 extension=php_tidy.dll
确保 extension_dir 指向正确的 ext 目录（通常 phpEnv 已配好，但可检查是否为 ext 而非绝对路径）
重启 Web 服务（Apache/Nginx）或 CLI 环境（关掉再开命令行）
运行 php -m | findstr tidy，输出 tidy 即表示加载成功

用 tidy::repairString 修复 HTML 常见问题

启用后，tidy_repair_string() 是最轻量、最常用的修复方式，适合模板渲染后、用户提交后等场景做兜底清洗：

Wechat HTML Publisher

直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

下载

不要依赖 tidy.clean_output = On（PHP INI 中的全局开关），它会干扰响应头、破坏 UTF-8 BOM、甚至导致乱码；始终用函数/类显式调用
常见修复目标：自动闭合错位标签（<p><b>text</b></p> → 正确嵌套）、补全缺失的、转义非法字符

关键配置项建议：

$config = [
    'output-xhtml'   => true,
    'show-body-only' => false,
    'clean'          => true,
    'wrap'           => 0, // 不折行，保持原始结构
    'indent'         => true,
    'indent-spaces'  => 2,
    'doctype'        => 'omit', // 避免插入多余 doctype 干扰已有文档
];

示例调用：

$dirty = '<p>Hello <b>world!</b></p><div><h1>Title</h1></div>';
$clean = tidy_repair_string($dirty, $config, 'UTF8');
echo htmlspecialchars($clean); // 输出前务必转义，避免 XSS 风险

为什么 tidy_parse_string() 返回空或报 Warning

这个错误大多不是代码写错，而是环境或输入层面的问题：

tidy_parse_string() 要求输入是合法字符串，不能是 null、false 或未定义变量；建议先 is_string($html) && trim($html) 校验
编码不匹配：即使指定了 'UTF8'，若原始字符串含 GBK 字节但被当 UTF-8 解析，tidy 会静默失败；可用 mb_detect_encoding() 辅助判断
内存限制：大 HTML（>2MB）可能触发 Allowed memory size exhausted；tidy 不支持流式处理，超限时只能切片或换用其他方案（如 DOMDocument + 自定义修复逻辑）
Windows 下路径分隔符不影响，但若配置数组里用了中文冒号、全角空格等隐藏字符，会导致解析失败且无明确提示