必须存。slug字段需存入数据库以支持主键查询、保持URL历史一致性和SEO友好性;Eloquent-Sluggable默认写入,需在迁移中定义唯一字符串字段并配置模型的sluggable方法,启用onUpdate和正确设置source及separator,中文需手动转拼音或处理编码,路由查找需重写getRouteKeyName返回'slug'。

slug字段该不该存进数据库
必须存。虽然可以运行时动态生成,但会导致无法用 slug 做主键查询、丢失历史 URL 一致性、SEO 友好性归零。Eloquent-Sluggable 默认就是写入数据库的 slug 字段,前提是你的 migration 里已定义:
php artisan make:migration add_slug_to_posts_table --table=posts
$table->string('slug')->unique()->nullable();注意加 unique() 约束,否则重复 slug 会抛出 Illuminate\Database\QueryException。
安装 eloquent-sluggable 后怎么配置模型
不是装完包就能用,必须显式配置模型。以 Post 模型为例,需实现 Sluggable 接口并定义 sluggable() 方法:
use Cviebrock\EloquentSluggable\Sluggable;
class Post extends Model implements SluggableInterface
{use Sluggable;
public function sluggable(): array
{return [
'slug' => [
'source' => 'title',
'onUpdate' => true,
'separator' => '-',
]
];
}
}关键点:
-
onUpdate设为true才会在$post->title改变时自动更新 slug;默认是 false -
separator影响生成效果,比如设成'_'就会输出hello_world而非hello-world - 若 source 是多个字段(如
['title', 'category.name']),需确保关联已预加载,否则报Trying to get property 'name' of non-object
中文标题生成 slug 失败或全是问号
默认配置不支持中文。Eloquent-Sluggable 底层用的是 str_slug()(Laravel 8+ 已废弃)或 Str::slug(),它们依赖 iconv 或 mb_convert_kana 做 ASCII 转换,而中文未做映射时直接被过滤为空。解决方法是改用自定义源:
public function sluggable(): array
{return [
'slug' => [
'source' => function () {return mb_convert_kana($this->title, 'as'); // 先转全角/半角
},
'onUpdate' => true,
]
];
}更稳妥的做法是引入
cviebrock/eloquent-sluggable 的 sluggableSource 钩子,或在保存前手动处理:$post->slug = Str::slug(pinyin($post->title)); // 需配合 overtrue/pinyin 包否则你看到的只会是空字符串或一串
-。
路由中通过 slug 查找模型却 404
常见错误是没重写 getRouteKeyName()。Laravel 默认按 id 查,即使 URL 是 /post/hello-world,它仍会执行 WHERE id = 'hello-world'。必须在模型里声明:
public function getRouteKeyName(): string
{return 'slug';
}否则无论 slug 字段是否存在、是否唯一,都查不到。另外确认路由定义用了隐式绑定:
Route::get('/post/{post}', [PostController::class, 'show']);而不是 {post:id} 或硬编码参数名。如果用了 where('post', '[A-Za-z0-9\-]+') 却漏了 \- 转义,正则会截断 slug,导致部分路径匹配失败。










