Validácia
use Illuminate\Validation\Rule;
use RoundlyConsulting\Sluggable\Rules\UniqueSlug;
use RoundlyConsulting\Sluggable\Rules\ValidSlug;
$request->validate([
'slug' => ['nullable', 'string', ValidSlug::for(Product::class),
UniqueSlug::for(Product::class)->ignore($product)->where('clinic_id', $clinicId)],
]);
'slug' => ['nullable', 'array', UniqueSlug::for(Topic::class)->ignore($topic)], // every locale
'slug' => [Rule::uniqueSlug(Topic::class, 'slug')->locale('sk')],
'slug' => [UniqueSlug::for(Product::class)->within($clinic)], // scope from a model
'slug' => [UniqueSlug::for(Product::class)->scopeFromInput('clinic_id')], // opt-in: scope from input
'slug' => [new ValidSlug(separator: '-', maxLength: 255, unicode: false, lowercase: true, reserved: [])],UniqueSlug
- Používa presne logiku generovania — rozsahy, zmazané riadky, bez globálnych scopes, rezervované slová — a pri politike Normalize porovnáva normalizovanú hodnotu.
- ignore() preskočí upravovaný záznam (model alebo kľúč); locale('sk') overí len jeden jazyk.
- Hodnoty rozsahu sa nikdy nečítajú z požiadavky implicitne — vzniklo by tak orákulum „je tento slug obsadený?“ naprieč tenantmi. Pre každý stĺpec rozsahu: where(), potom atribút modelu z within() / ignore($model), potom — len pre stĺpce uvedené v scopeFromInput() — validované údaje; inak pravidlo vyhodí missingScopeValue.
- Vstup pre jazykovú mapu: reťazec znamená aktuálny jazyk (alebo jazyk z locale()); pole overí každý podporovaný jazyk; nepodporované jazyky sa ignorujú; chyby sa priradia k slug.{locale}.
ValidSlug
ValidSlug prejde, ak sa hodnota rovná svojej normalizácii, zmestí sa do maxLength a nie je rezervovaná. ValidSlug::for(Model::class) použije formát a rezervované slová definície; konštruktor ich prijíma explicitne, ako v poslednom príklade vyššie.
Makrá Rule
Rule::uniqueSlug(Model::class, $column) a Rule::validSlug(Model::class, $column) vracajú tie isté pravidlá a PHPStan ich pozná vďaka rozšíreniu balíka.
Hlášky
| Kľúč | Predvolená hláška |
|---|---|
sluggable::validation.unique | The :attribute has already been taken. |
sluggable::validation.unique_locale | The :attribute (:locale) has already been taken. |
sluggable::validation.format | The :attribute must be a valid slug (lowercase letters, numbers and separators). |
sluggable::validation.too_long | The :attribute may not be longer than :max characters. |
sluggable::validation.reserved | The :attribute is reserved and cannot be used. |
sluggable::validation.locked | The :attribute can no longer be changed. |
Na zmenu textu alebo preklad ich publikujte cez --tag=sluggable-translations.
Prejavte lásku k open source
Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.
Ďalšie spôsoby podpory vrátane kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
Chcete to zabudovať do svojho produktu?
Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.