Eloquent中应仅在访问器（getContentAttribute）或Cast中用nl2br()处理换行， setContentAttribute保持原样；数据库存纯文本（含\n），前端用pre-wrap或模板中{{ $model->content }}直接输出，API需在Resource中显式处理，避免XSS和重复换行。
PHP中Eloquent模型的getFooAttribute和setFooAttribute怎么写才不踩坑
直接用访问器（Accessor）和修改器（Mutator）做文本自动换行，核心是别在数据库字段上存换行符，而是在读取时动态处理。否则会污染原始数据、破坏JSON兼容性、影响全文索引。
常见错误是把nl2br()硬塞进setContentAttribute，导致数据库里存的是带<br>的HTML，后续API返回时再套一层nl2br()就变成双<br><br>——页面炸开。
- 只在
getContentAttribute里调用nl2br()，保证数据库存纯文本（含\n） -
setContentAttribute保持原样接收，不做任何转换 - 如果前端需要保留空格+换行（比如日志、代码片段），改用
white-space: pre-wrapCSS + 原始换行符，比nl2br()更可控
Laravel 10+里用cast自动包装text字段换行显示
Cast比手动写Accessors更轻量，适合统一处理多个字段。但注意：cast只影响$model->content读取，不影响$model->getOriginal('content')或toArray()原始值。
定义一个TextWithBreaksCast类：
立即学习“PHP免费学习笔记（深入）”；
use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
class TextWithBreaksCast implements CastsAttributes
{
public function get($model, string $key, $value, array $attributes)
{
return $value ? nl2br(e($value)) : '';
}
public function set($model, string $key, $value, array $attributes)
{
return $value;
}
}
然后在模型里声明：
protected $casts = [
'content' => TextWithBreaksCast::class,
];
- 必须用
e()先转义HTML实体，再nl2br()，否则用户输入<script></script>会被执行 - 这个cast不会改变数据库存储格式，
content字段仍是TEXT类型，存\n - 如果字段可能为null，
get()里要判空，否则nl2br(null)返回"<br>"
Blade模板里要不要再nl2br？怎么判断
取决于你用的是accessor、cast，还是直接输出原始字段。最容易混淆的地方就在这儿。
- 用了
getContentAttribute或cast → 模板里直接{{ $post->content }}，不能再{{ nl2br($post->content) }} - 没做任何包装 → 必须用
{{ nl2br(e($post->content)) }}，且e()不能漏 - 用
{!! $post->content !!}？危险！除非你100%确认内容可信（如后台管理员输入），否则XSS风险极高
一个快速验证方法：dd输出$post->content，看里面是否已含<br>。有，说明包装已生效；没有，就得在模板补。
API接口返回时自动换行失效？检查response transformer
用toArray()或Resource时，Eloquent accessor默认不触发，cast也可能被绕过——这是最常被忽略的环节。
- Resource里显式调用：
'content' => nl2br(e($this->content)) - 或者在Resource的
toArray()里重写字段，而不是依赖模型原始$casts - 如果用了
makeHidden(['content'])又在Resource里重新暴露，accessor不会自动运行，得手动处理 - 调试技巧：在Resource构造函数里
dd($this->resource->content)，确认值是否已被包装
复杂点在于，同一个字段在Web页面、API、队列任务里可能走不同路径，包装逻辑必须对齐，否则前端看到的换行效果不一致。
