本文详解如何在 php 模板中正确组合 echo 与 substr() 函数，安全、简洁地截取字符串并输出，避免语法错误，同时提供 css 备选方案与实用注意事项。
本文详解如何在 php 模板中正确组合 echo 与 substr() 函数，安全、简洁地截取字符串并输出，避免语法错误，同时提供 css 备选方案与实用注意事项。
在 PHP 开发中，常需对文章摘要、卡片内容等文本做长度限制（如仅显示前 50 个字符），以提升页面可读性与加载性能。初学者容易误写成 substr(echo $str, 0, 50) 这类语法错误——因为 echo 是语言结构（statement），不能作为函数参数；而 substr() 是函数，必须 先处理字符串，再输出结果。
✅ 正确写法（推荐）：
将 substr() 的返回值直接传给 echo：
<p class="card-text"> <?php echo substr($q['content'], 0, 50); ?> </p>⚠️ 注意事项：
- substr($str, $start, $length) 第二个参数为起始位置（从 0 开始），第三个参数为截取长度；
- 若原文长度不足 50 字符，substr() 自动返回全部内容，不会报错；
- 中文、emoji 或 UTF-8 多字节字符可能被截断乱码（如 “ 你好世界 ” → substr(…, 0, 5) 可能输出 “ 你好世 ”）。此时应改用 mb_substr()（需启用 mbstring 扩展）：
<p class="card-text"> <?php echo mb_substr($q['content'], 0, 50, 'UTF-8'); ?> </p>? 进阶建议：添加省略号（……）增强语义
单纯截断易造成语义不完整，推荐追加省略号（注意判断是否真有截断）：
<?php $content = $q['content']; $excerpt = mb_substr($content, 0, 50, 'UTF-8'); $hasMore = mb_strlen($content, 'UTF-8') > 50; ?> <p class="card-text"> <?php echo htmlspecialchars($excerpt); ?><?php echo $hasMore ? '……' : ''; ?> </p>? 安全提醒：始终对输出内容进行 htmlspecialchars() 转义，防止 XSS 攻击（尤其当 $q[‘content’] 来自用户输入时）。
? 替代方案：纯 CSS 截断（适用于样式优先场景）
若仅需视觉截断且无需服务端逻辑，CSS 方案更轻量、响应式友好：
<style> .card-text {display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 3; /* 显示 3 行 */ overflow: hidden; line-height: 1.5; max-height: 4.5em;} </style>或单行省略（带 text-overflow: ellipsis）：
立即学习“PHP 免费学习笔记（深入）”；
.card-text {white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 300px;}✅ 总结：
- echo substr($str, 0, N) 是最直接可靠的 PHP 截断方式；
- 处理中文 / 多字节字符务必用 mb_substr() + 指定 ‘UTF-8’ 编码；
- 输出前执行 htmlspecialchars() 是安全开发的强制习惯；
- CSS 截断适合静态展示，PHP 截断适用于 SEO、API 或需精确控制摘要内容的场景。
