SuperAPI AI 工具集

sluggable-development

编程与开发

查看项目

更新于 10-16 06:43

技能介绍

用途:为 Laravel Eloquent 模型的字段生成 slug,写入可配置列,保持唯一,并可将路由键变为容忍 slug 变化的自愈 URL。

主要能力:模型创建或更新时自动生成 slug;支持唯一后缀、自定义后缀生成、范围限定、跳过条件、可翻译 slug(JSON 列)、findBySlug() 查询、自愈路由键(slug-id 形式,旧 slug 返回 308 重定向,缺失标识返回 404),以及通过 SelfHealing 门面自定义重定向。

配置方式:类上使用 #[Sluggable(from: 'title', to: 'slug')] 属性,适用于大多数模型;需要 callable 来源、extraScope、skipGenerateWhen、自定义后缀、可翻译 slug、findBySlug() 或自愈 URL 时,使用 HasSlug trait + getSlugOptions()。两者同时存在时 trait 优先,属性被忽略。属性参数包括 from、to、separator、language、maxLength、unique、onCreate、onUpdate、preventOverwrite、selfHealing、selfHealingSeparator;trait 还提供 generateSlugsFrom、saveSlugsTo、extraScope、skipGenerateWhen、usingSuffixGenerator、startSlugSuffixFrom、useSuffixOnFirstOccurrence、allowDuplicateSlugs 等链式选项。

必要用法:迁移中需为目标表添加与 to 或 saveSlugsTo() 匹配的列,可用 php artisan make:migration add_slug_to_posts_table,迁移内用 $table->string('slug')->nullable()->after('title') 与 $table->unique('slug');可翻译 slug 用 $table->json('slug')。路由可用 Route::get('/posts/{post:slug}', ...) 或重写 getRouteKeyName()。

适用场景:内容、文章、产品等需要友好 URL 的模型;需要链接在标题变化后仍可用的场景。

限制:仅通过属性配置的模型无 findBySlug();自愈 URL 必须使用 trait,否则抛出 SelfHealingRequiresTrait;属性不支持闭包;可翻译 slug 需结合 spatie/laravel-translatable 并将列设为 JSON;给已有数据的表加列时应先 nullable 并回填,再强制唯一索引。自定义底层动作需发布配置:php artisan vendor:publish --tag=sluggable-config。