本文详解如何正确组合 PHP 的 echo 与 substr() 在单行中安全截取并输出字符串（如博客摘要），纠正常见语法错误，并提供兼容性好、语义清晰的实践方案。
本文详解如何正确组合 php 的 `echo` 与 `substr()` 在单行中安全截取并输出字符串（如博客摘要），纠正常见语法错误，并提供兼容性好、语义清晰的实践方案。
在 PHP 开发中，常需对长文本（如文章内容）进行字符截断后展示，例如在首页卡片中仅显示前 50 个字符并添加省略号。初学者容易误写为 substr(echo $str, 0, 50)——这是语法错误：echo 是语言结构（非函数），不能作为 substr() 的参数；substr() 本身也不具备输出能力，它只返回子字符串。
✅ 正确做法是：先用 substr() 提取子串，再用 echo 输出结果。二者可自然组合在一行中，无需嵌套调用：
<p class="card-text"><?php echo substr($q['content'], 0, 50); ?></p>
若需添加省略号（…）以明确表示内容被截断，可进一步优化为：
<p class="card-text">
<?php
$excerpt = substr($q['content'], 0, 50);
echo strlen($q['content']) > 50 ? $excerpt . '…' : $excerpt;
?>
</p>⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- substr() 第二个参数为起始位置（从 0 开始），第三个为长度（非结束位置）；
- 若原文含中文、Emoji 等 UTF-8 多字节字符，直接使用 substr() 可能导致乱码（因按字节而非字符截取）。此时应改用 mb_substr()（需启用 mbstring 扩展）：
<?php echo mb_substr($q['content'], 0, 50, 'UTF-8'); ?>- 建议配合 htmlspecialchars() 防止 XSS：echo htmlspecialchars(mb_substr($q['content'], 0, 50, 'UTF-8'));
此外，前端 CSS 截断（如 -webkit-line-clamp）虽便捷，但无法替代后端截取：它仅控制渲染效果，原始 HTML 仍包含全部内容，存在 SEO 泄露和性能隐患。真正需要控制传输体积或保障内容安全时，务必在 PHP 层完成截取。
综上，一行内正确使用 echo 与 substr 的核心原则是：分离“计算”与“输出”职责——substr() 负责生成子串，echo 负责呈现结果。理解这一逻辑，即可写出简洁、健壮、可维护的模板代码。
