PHP前台字符串截取：从基础到高级，实现高效优雅的文本展示23

在现代Web应用开发中，PHP作为服务器端脚本语言的佼佼者，广泛应用于构建各种规模的前台界面。当数据从后端数据库检索出来，准备呈现在用户面前时，经常会遇到一个挑战：如何优雅、高效地处理过长的文本内容？例如，文章列表的摘要、商品描述的预览、用户评论的截取等等。这时，“字符串截取”就成为了一个必不可少的技术环节。它不仅关乎页面的美观和用户体验，更直接影响到信息的有效传达和前端界面的整洁。

本文将作为一份全面的指南，从PHP内置的基础字符串截取函数出发，深入探讨在前端展示中可能遇到的各种复杂场景，包括多字节字符处理、HTML标签的处理、保持单词完整性以及性能优化和安全考量。我们将通过丰富的代码示例，为您展示如何构建一个功能强大且高度可复用的字符串截取方案，确保您的PHP前台显示既美观又专业。

一、基础篇：PHP内置字符串截取函数

PHP提供了一些原生的函数来处理字符串截取，其中最常用的是substr()和mb_substr()。理解它们之间的差异和适用场景是高效字符串处理的第一步。

1.1 substr()：简单直接的截取利器

substr()函数是PHP中最基础的字符串截取函数，适用于处理单字节字符集（如ASCII编码）的字符串。它的语法非常直观：
string substr ( string $string , int $start [, int $length ] )

$string：要截取的原字符串。
$start：起始位置。如果为非负数，则从$string的开头算起。如果为负数，则从$string的末尾算起。
$length：截取长度。如果省略，则截取从$start到字符串末尾的所有字符。如果为正数，则截取指定长度。如果为负数，则截取到从字符串末尾开始的$length个字符。

示例：
$text = "PHP is a popular general-purpose scripting language.";
// 从第0个字符开始，截取前10个字符
echo substr($text, 0, 10); // 输出: PHP is a p
// 从第10个字符开始，截取到字符串末尾
echo substr($text, 10); // 输出: opular general-purpose scripting language.
// 从倒数第10个字符开始，截取所有字符
echo substr($text, -10); // 输出: language.
// 从倒数第20个字符开始，截取10个字符
echo substr($text, -20, 10); // 输出: scripting

局限性： substr()按字节进行截取。对于包含中文、日文、韩文等UTF-8多字节字符的字符串，直接使用substr()会导致乱码或截取不完整的问题。这是因为它可能在一个多字节字符的中间进行截断，破坏了字符编码结构。

1.2 mb_substr()：多字节字符的守护者

为了解决多字节字符集的截取问题，PHP提供了多字节字符串函数库（Multibyte String Functions），其中mb_substr()是对应substr()的多字节版本。它是处理中文等UTF-8编码字符串的必备工具。
string mb_substr ( string $string , int $start [, int $length = NULL [, string $encoding = NULL ]] )

$string：要截取的原字符串。
$start：起始位置（字符数，而非字节数）。
$length：截取长度（字符数，而非字节数）。
$encoding：字符编码，如'UTF-8'、'GBK'等。如果省略或为NULL，则使用内部字符编码。强烈建议明确指定为'UTF-8'，以避免潜在问题。

示例：
$chineseText = "PHP是一种流行的通用脚本语言。";
// 使用substr截取（错误示例）
echo "substr截取（可能乱码）：" . substr($chineseText, 0, 10) . " ";
// 输出可能为：substr截取（可能乱码）：PHP是一种流行的通�
// 使用mb_substr截取前10个字符（正确示例）
echo "mb_substr截取： " . mb_substr($chineseText, 0, 10, 'UTF-8') . " ";
// 输出: mb_substr截取： PHP是一种流行的通用脚
// 配合mb_strlen获取字符串长度
$len = mb_strlen($chineseText, 'UTF-8');
echo "字符串总长度（字符数）：" . $len . " "; // 输出: 17
// 从倒数第5个字符开始截取
echo "从倒数第5个字符开始截取：" . mb_substr($chineseText, -5, null, 'UTF-8'); // 输出: 脚本语言。

注意：为了确保mb_substr()的正常工作，需要确保PHP环境已启用mbstring扩展。在中找到并取消注释extension=mbstring即可。

二、进阶篇：优化与实践

仅仅进行简单的字符串截取往往不能满足前端展示的需求。我们还需要处理诸如添加省略号、保留单词完整性、处理HTML标签等更复杂的场景。

2.1 添加省略号 (...)

当字符串被截断时，通常需要添加一个省略号（...）来提示用户内容未完全显示。这需要一个条件判断：只有当原字符串长度超过截取长度时才添加。
function truncateWithEllipsis($string, $maxLength, $encoding = 'UTF-8') {
if (mb_strlen($string, $encoding) > $maxLength) {
return mb_substr($string, 0, $maxLength, $encoding) . '...';
}
return $string;
}
$text = "这是一个非常长的文本内容，需要被截取并在末尾添加省略号。";
echo truncateWithEllipsis($text, 15); // 输出: 这是一个非常长的文本...
echo " ";
echo truncateWithEllipsis("短文本", 15); // 输出: 短文本

2.2 保留完整单词，避免截断尴尬

直接按字符数截取可能会在一个单词的中间截断，这在英文语境下会显得非常不自然。例如，“beautiful”被截成“beautif...”。更好的做法是截取到最后一个完整单词的末尾。

实现这个功能通常需要结合mb_substr()和mb_strrpos()（查找子字符串最后一次出现的位置）或正则表达式。
function truncateWords($string, $maxLength, $suffix = '...', $encoding = 'UTF-8') {
if (mb_strlen($string, $encoding) $maxLength) {
return mb_substr($plainText, 0, $maxLength, $encoding) . $suffix;
}
return $plainText;
}
$htmlContent = "这是一个包含HTML标签的富文本内容，非常<a href="#">适合展示摘要</a>。";
echo truncateHtmlSafe($htmlContent, 20); // 输出: 这是一个包含HTML标签的富文本内容，非常适合展...

这种方法简单有效，适用于需要纯文本摘要的场景。缺点是会丢失所有格式信息。

2.3.2 截取并尝试保留部分HTML标签（复杂且不推荐新手尝试）

在某些高级场景下，可能需要截取文本的同时，尽量保留其格式（如粗体、链接）。这非常复杂，因为需要解析HTML，智能地闭合未闭合的标签。直接使用字符串截取函数几乎不可能正确实现，强烈不建议手动编写。这通常需要借助成熟的第三方HTML解析库（如）或专门的CMS功能。

如果坚持要尝试，一个简化的思路是先将HTML转换为DOM对象，然后遍历节点，按文本内容进行计数截取，并在达到长度时停止并闭合所有打开的标签。这涉及到DOM操作，远超字符串函数范畴，并且维护成本极高，容易出错。在大多数前台展示需求中，移除HTML标签才是最佳实践。

三、封装与重用：打造通用截取函数

为了提高代码的复用性和可维护性，我们可以将上述所有逻辑封装到一个通用的函数中。这个函数可以接受多个参数来控制截取的行为。
/
* 强大的字符串截取函数，支持多字节、省略号、保留单词和HTML标签处理
*
* @param string $string 原始字符串
* @param int $length 截取长度（字符数）
* @param string $suffix 省略号后缀，默认为'...'
* @param bool $stripTags 是否移除HTML标签，默认为true
* @param bool $preserveWords 是否尝试保留完整单词（对中文效果不佳），默认为false
* @param string $encoding 字符编码，默认为'UTF-8'
* @return string 截取后的字符串
*/
function smartTruncate(
$string,
$length,
$suffix = '...',
$stripTags = true,
$preserveWords = false,
$encoding = 'UTF-8'
) {
// 1. 如果需要，先移除HTML标签
if ($stripTags) {
$string = strip_tags($string);
}
// 2. 获取实际字符串长度
$stringLength = mb_strlen($string, $encoding);
// 3. 如果原始字符串长度小于等于目标长度，直接返回
if ($stringLength content, 100))
{!! $truncated !!}

前端JavaScript截取：有时，为了更好的用户体验（例如实时预览、无需页面刷新的动态内容），也可以在前端使用JavaScript进行字符串截取。

function jsTruncate(str, length, suffix = '...') {
if (