在ThinkPHP模型中用getSummaryAttr定义访问器自动生成摘要,优先读取$data['summary'],否则从$content提取:先strip_tags()去HTML、trim()清空格、mb_substr()安全截取,并处理图片/引用块干扰及标点停顿。

ThinkPHP 模型中怎么用 getSummaryAttr 自动生成摘要
直接在模型里定义访问器(Accessor)是最轻量、最可控的方式。ThinkPHP 会自动识别形如 getXXXAttr 的方法,当读取字段(比如 $article->summary)时触发,无需修改数据库或额外调用。
常见错误是把逻辑写在控制器里手动截取,导致重复代码、模板里无法直接用 {$article.summary},还容易漏掉 HTML 剥离或空格处理。
实操建议:
- 在模型类中添加方法:
public function getSummaryAttr($value, $data) { ... },$value是数据库原值(可能为空),$data是当前模型完整数据数组 - 优先从
$data['content']提取,而不是依赖已存的summary字段 —— 这样即使数据库里没存摘要,也能实时生成 - 务必先用
strip_tags()去除 HTML 标签,再用trim()清理首尾空白,否则可能截出换行符或空格开头的“摘要” - 中文场景推荐用
mb_substr()而非substr(),避免 UTF-8 下乱码或截断半个汉字
为什么不能直接用 substring 或 str_limit 辅助函数
ThinkPHP 自带的 str_limit()(或 Laravel 风格的 Str::limit())只做简单截断,不处理换行、多余空格、HTML 标签,也不考虑标点截断的语义合理性。直接套用常导致摘要末尾出现“……”或“的 ”这类尴尬结尾。
更关键的是:这些函数无法感知上下文。比如你想跳过开头的 或广告段落,或者排除「编辑推荐」「作者声明」等固定前缀,就必须在访问器里定制逻辑。
实操建议:
- 不要在模板里写
{:str_limit($article.content, 120)}—— 这会让同一字段在不同模板里截取逻辑不一致 - 如果必须复用,可封装一个静态工具方法,例如
Text::extractSummary($html, $length = 120),但依然应在模型访问器中调用它,保持数据层统一 - 注意
str_limit()默认用...作省略符,而中文习惯用……(U+2026),建议显式传参替换
数据库字段 summary 还要不要存
要,但仅用于人工覆盖场景。自动生成摘要适合默认展示,但编辑人员有时需要写更精准、带关键词的导语,这时应允许后台表单填写并保存到 summary 字段 —— 模型访问器需优先返回该字段值,回退到自动生成。
容易踩的坑是“全量覆盖”:每次保存文章都强制重写 summary,导致人工编辑丢失;或者完全弃用字段,后期想加 SEO 描述时又得改结构。
实操建议:
- 访问器里判断:
if (!empty($data['summary'])) return $data['summary'];,再 fallback 到内容提取逻辑 - 在后台编辑表单中,
summary字段设为可选,带 placeholder 提示“留空将自动生成” - 如果业务要求摘要必须存在(如 RSS 输出),可在模型的
save()前置钩子中检查并补全,而非依赖读取时生成
长文本含图片、引用块时怎么避免摘要崩坏
纯 strip_tags() 会把 、 标签干掉,但残留的 alt 文本、引用文字仍可能撑满长度,或让摘要变成一串无意义的图片说明。
更隐蔽的问题是 Markdown 渲染后的内容(如 ## 标题 → )被截断在标签中间,导致前端解析异常。
实操建议:
- 若内容经 Markdown 解析入库,摘要提取前先还原成纯文本(如用
league/commonmark的PlainTextRenderer),别直接对 HTML 截取 - 对常见干扰块加正则过滤,例如
preg_replace('/]*>.*?/is', '', $html) - 截取后用
preg_replace('/\s+/', ' ', $text)合并连续空白,避免“标题 ……正文”这种多空格现象
真正难的不是截多少字,而是判断哪里该停——比如遇到句号、问号、换行符就优先在此处截断,而不是硬卡长度。这需要结合分词或规则引擎,但大多数项目用“先去标签、再压缩空白、最后按字数截 + 保证标点完整性”的三层处理,已经够用。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











