在开发一个内容管理系统时,我遇到了一个棘手的问题:用户提交的文本中包含了大量的直引号、连字符和省略号。这些符号在最终的 html 输出中显得不够美观,影响了用户体验。为了解决这个问题,我尝试了多种方法,最终发现了 michelf/php-smartypants 这个库,它不仅解决了我的问题,还大大提升了文本的排版质量。
michelf/php-smartypants 是一个 PHP 库,专门用于将普通的 ASCII 标点符号转换为“智能”排版符号。它由 Michel Fortin 开发,是 John Gruber 的 SmartyPants 的 PHP 版本。这个库可以执行以下转换:
- 将直引号 (
"和') 转换为“弯曲”引号 HTML 实体。 - 将反引号风格的引号 (``
like this'') 转换为“弯曲”引号 HTML 实体。 - 将连字符 (
--和---) 转换为 en 和 em 破折号实体。 - 将三个连续的点 (
...) 转换为省略号实体。
此外,michelf/php-smartypants 的 Typographer 版本还可以执行更多转换:
- 将法语引号 (
和>>) 转换为真正的 « 引号 » HTML 实体。 - 将逗号风格的引号 (
,,like this``` 或''like this,,`) 转换为其弯曲等价物。 - 在标点符号周围适当地替换现有空格为不间断空格,也可以根据配置添加或删除它们。
- 将数字和后面的单位符号之间的空格替换为不间断空格(适用于大多数常见单位)。
使用这个库,你可以使用普通的 ASCII 直引号、连字符和点来编写、编辑和保存文本,但最终的 HTML 输出将显示为智能引号、em 破折号、正确的省略号和不间断空格(使用 Typographer 版本)。
安装 michelf/php-smartypants 非常简单,只需使用 Composer:
立即学习“PHP免费学习笔记(深入)”;
composer require michelf/php-smartypants
使用示例:
use Michelf\SmartyPants; $html_output = SmartyPants::defaultTransform($html_input);
如果你需要使用 Typographer 版本,可以这样做:
use Michelf\SmartyPantsTypographer; $html_output = SmartyPantsTypographer::defaultTransform($html_input);
使用 michelf/php-smartypants 后,我的内容管理系统的文本排版得到了显著提升,用户体验也得到了改善。这个库不仅解决了我的排版问题,还提供了灵活的配置选项,使得我可以根据具体需求进行调整。
总结来说,michelf/php-smartypants 是一个强大的工具,能够帮助你在 PHP 中轻松实现高质量的文本排版。它不仅易于安装和使用,还提供了丰富的功能和配置选项,使得你的内容更加美观和专业。如果你在处理文本排版方面遇到了类似的问题,不妨尝试使用这个库。











