最近在为一个内容管理系统（CMS）开发新功能，其中一个核心需求是将用户输入的富文本内容（HTML格式）转换成纯文本，以便在邮件通知、系统日志或搜索引擎摘要中使用。这个看似简单的任务，却给我带来了不小的麻烦。
遇到的困难：HTML到纯文本的“陷阱”
起初，我天真地以为，用几个正则表达式把HTML标签过滤掉就行了。然而，现实很快给了我一记响亮的耳光。
-
可读性问题：简单地移除标签会导致文本内容挤成一团，丢失了原有的段落、列表和表格结构，用户根本无法阅读。例如，
HelloWorld，而不是Hello\nWorld。 -
复杂标签处理：
<script></script>、等标签的内容需要被完全忽略，而不是被当作普通文本处理。 -
实体字符转换：
&、等HTML实体需要正确地转换回它们对应的字符。 - 性能与维护：随着HTML结构越来越复杂，手写的正则表达式变得异常庞大且难以维护，稍有不慎就会引入新的bug。每次遇到新的HTML结构，都得小心翼翼地修改正则，这简直是噩梦。
我尝试了各种“土法炼钢”的方案，但都无法兼顾转换的准确性、可读性和代码的简洁性。我的代码变得越来越臃肿，每次测试都提心吊胆，生怕遗漏了什么边缘情况。
救星登场：Nineteenfeet/nf-html-to-text
正当我一筹莫展之际，我在Composer包管理器中偶然发现了nineteenfeet/nf-html-to-text这个库。它的描述非常简洁：“Simple conversion of HTML to plain text”，这正是我所需要的！
nineteenfeet/nf-html-to-text是一个专注于将HTML内容转换为可读性强的纯文本的PHP库。它不像其他一些大型HTML解析库那样功能繁杂，而是专注于核心的转换任务，做到了小巧、高效且易于使用。
如何使用它解决问题
集成nineteenfeet/nf-html-to-text到我的项目中非常简单，只需通过Composer安装即可：
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
composer require nineteenfeet/nf-html-to-text 1.*
安装完成后，使用起来更是直观：
<?php require 'vendor/autoload.php'; // 引入Composer的自动加载文件
use NF\HtmlToText;
$htmlString = '
<h1>欢迎来到我的博客
<p>这是一个<strong>非常棒</strong>的段落，包含了一些<em>斜体</em>文字。</p>
- 列表项一
- 列表项二
点击这里访问 示例网站。
这后面还有一些文字。
'; $htmlToText = new HtmlToText(); $textString = $htmlToText->convert($htmlString); echo $textString; /* 输出结果大致如下： 欢迎来到我的博客 这是一个非常棒的段落，包含了一些斜体文字。 * 列表项一 * 列表项二 点击这里访问 示例网站。 [示例图片] 这后面还有一些文字。 */ ?>
仅仅几行代码，就将复杂的HTML内容转换成了格式清晰、易于阅读的纯文本。它自动处理了：
- 标题、段落的换行。
- 列表项的格式化（添加了
*前缀）。 - 链接文本的提取。
- 图片
alt属性的提取。 - HTML实体字符的解码。
总结与应用效果
使用nineteenfeet/nf-html-to-text之后，我的开发效率得到了显著提升。我不再需要为HTML到纯文本的转换而头疼，可以将更多精力投入到核心业务逻辑的开发中。
这个库的优势在于：
- 简洁高效：API设计简单，核心功能明确，没有不必要的复杂性。
- 可读性强：它不仅仅是移除标签，更重要的是保留了HTML原有的语义结构，使得转换后的纯文本依然易于理解。
- 易于集成：作为Composer包，安装和使用都非常便捷。
- 可靠性高：它能够处理各种常见的HTML结构，减少了因手动处理而引入的错误。
无论是邮件通知系统、内容摘要生成器，还是任何需要将HTML内容展示在非HTML环境中的场景，nineteenfeet/nf-html-to-text都是一个非常值得推荐的工具。它让我告别了HTML转换的“乱象”，让我的代码更优雅，工作更轻松。如果你也曾被HTML到纯文本的转换问题所困扰，不妨试试这个小巧而强大的库，相信它会给你带来惊喜！
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
