spatie/laravel-sluggable

What's Changed

• Fix unique slug generation when the slug or separator contains a LIKE wildcard (_, %, \) by @amrachraf6699 in #311

  On drivers without a default LIKE escape character (SQLite), the slug-variant lookup silently matched nothing, so a separator like _ caused suffixes to be reused (foo_bar_1 twice instead of foo_bar_2).

Full Changelog: 4.0.2...4.0.3

What's Changed

• Fix unique slug generation when the slug or separator contains a LIKE wildcard (_, %, \) by @amrachraf6699 in https://github.com/spatie/laravel-sluggable/pull/311

  On drivers without a default LIKE escape character (SQLite), the slug-variant lookup silently matched nothing, so a separator like _ caused suffixes to be reused (foo_bar_1 twice instead of foo_bar_2).

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/4.0.2...4.0.3

Full Changelog: 4.0.0...4.0.1

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/4.0.0...4.0.1

v4 is mostly additive. Breaking changes are limited to minimum versions and a small handful of API removals. Full details in UPGRADING.md.

Highlights

• #[Sluggable] attribute as a drop-in alternative to the HasSlug trait. Trait-based models keep working unchanged.
• Self-healing URLs: route keys that combine the slug with the primary key (hello-world-5) so renaming a model never breaks an existing link. Stale URLs return a 308 (was 301) so PUT/PATCH/DELETE keep working.
• Overridable actions: swap the slug generator or self-healing URL builder/parser via config/sluggable.php.
• Laravel Boost skill bundled with the package for AI assistants.

Breaking changes

• Minimum PHP 8.3 and Laravel 12. spatie/laravel-translatable v6+ when using HasTranslatableSlug. Pest 4 / Testbench 10+ in your test suite.
• skipGenerateWhen() is now evaluated on every save instead of once. The SlugOptions::\$skipGenerate boolean is gone in favor of \$skipGenerateWhen.
• The closure-shaped options (generateSlugsFrom, extraScope, usingSuffixGenerator, skipGenerateWhen) are typed as Closure. Array/string callables need wrapping in a fn.
• HasSlug no longer keeps a protected \$slugOptions cache; override generateSlugAction() to inject custom behavior instead.
• Self-healing redirects default to 308 Permanent Redirect.
• The Sluggable facade was renamed to SelfHealing.

See UPGRADING.md for migration steps.

v4 is mostly additive. Breaking changes are limited to minimum versions and a small handful of API removals. Full details in UPGRADING.md.

Highlights

• #[Sluggable] attribute as a drop-in alternative to the HasSlug trait. Trait-based models keep working unchanged.
• Self-healing URLs: route keys that combine the slug with the primary key (hello-world-5) so renaming a model never breaks an existing link. Stale URLs return a 308 (was 301) so PUT/PATCH/DELETE keep working.
• Overridable actions: swap the slug generator or self-healing URL builder/parser via config/sluggable.php.
• Laravel Boost skill bundled with the package for AI assistants.

Breaking changes

• Minimum PHP 8.3 and Laravel 12. spatie/laravel-translatable v6+ when using HasTranslatableSlug. Pest 4 / Testbench 10+ in your test suite.
• skipGenerateWhen() is now evaluated on every save instead of once. The SlugOptions::\$skipGenerate boolean is gone in favor of \$skipGenerateWhen.
• The closure-shaped options (generateSlugsFrom, extraScope, usingSuffixGenerator, skipGenerateWhen) are typed as Closure. Array/string callables need wrapping in a fn.
• HasSlug no longer keeps a protected \$slugOptions cache; override generateSlugAction() to inject custom behavior instead.
• Self-healing redirects default to 308 Permanent Redirect.
• The Sluggable facade was renamed to SelfHealing.

See UPGRADING.md for migration steps.

What's Changed

• Fix preventOverwrite for translatable slugs (#304)

Thanks to @jyrkidn for reporting and providing the initial fix in #302.

What's Changed

• Fix preventOverwrite for translatable slugs (#304)

Thanks to @jyrkidn for reporting and providing the initial fix in #302.

What's Changed

• Add Laravel 13 and PHP 8.5 support
• Drop Laravel 8/9 and PHP 8.0/8.1 (EOL)

What's Changed

• Add Laravel 13 and PHP 8.5 support
• Drop Laravel 8/9 and PHP 8.0/8.1 (EOL)

What's Changed

• Also account for HasManyThrough / BelongsToMany relations by @mabdullahsari in #291

New Contributors

• @mabdullahsari made their first contribution in #291

Full Changelog: 3.7.4...3.7.5

What's Changed

• Also account for HasManyThrough / BelongsToMany relations by @mabdullahsari in https://github.com/spatie/laravel-sluggable/pull/291

New Contributors

• @mabdullahsari made their first contribution in https://github.com/spatie/laravel-sluggable/pull/291

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.4...3.7.5

What's Changed

• Allow to generate custom suffixes by @josepdecid in #289

New Contributors

• @josepdecid made their first contribution in #289

Full Changelog: 3.7.3...3.7.4

What's Changed

• Allow to generate custom suffixes by @josepdecid in https://github.com/spatie/laravel-sluggable/pull/289

New Contributors

• @josepdecid made their first contribution in https://github.com/spatie/laravel-sluggable/pull/289

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.3...3.7.4

What's Changed

• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in #287
• Laravel 12.x Compatibility by @laravel-shift in #288

Full Changelog: 3.7.2...3.7.3

What's Changed

• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/287
• Laravel 12.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-sluggable/pull/288

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.2...3.7.3

What's Changed

• Fix query for translatable slug by @andrii-trush in #285

New Contributors

• @andrii-trush made their first contribution in #285

Full Changelog: 3.7.1...3.7.2

What's Changed

• Fix query for translatable slug by @andrii-trush in https://github.com/spatie/laravel-sluggable/pull/285

New Contributors

• @andrii-trush made their first contribution in https://github.com/spatie/laravel-sluggable/pull/285

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.1...3.7.2

What's Changed

• Add explicit nullable type for additionalQuery parameter by @RomkaLTU in #286

New Contributors

• @RomkaLTU made their first contribution in #286

Full Changelog: 3.7.0...3.7.1

What's Changed

• Add explicit nullable type for additionalQuery parameter by @RomkaLTU in https://github.com/spatie/laravel-sluggable/pull/286

New Contributors

• @RomkaLTU made their first contribution in https://github.com/spatie/laravel-sluggable/pull/286

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.7.0...3.7.1

What's Changed

• Changing reference to Laravel docs without Laravel version by @abishekrsrikaanth in https://github.com/spatie/laravel-sluggable/pull/274
• Bump dependabot/fetch-metadata from 1.6.0 to 2.1.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/278
• Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/281
• Add Fallback Locale and Additional Query Support to findBySlug by @mkeremcansev in https://github.com/spatie/laravel-sluggable/pull/284

New Contributors

• @abishekrsrikaanth made their first contribution in https://github.com/spatie/laravel-sluggable/pull/274
• @mkeremcansev made their first contribution in https://github.com/spatie/laravel-sluggable/pull/284

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.6.0...3.7.0

What's Changed

• Bump dependabot/fetch-metadata from 1.4.0 to 1.5.1 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/257
• Bump dependabot/fetch-metadata from 1.5.1 to 1.6.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/261
• Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/264
• Add laravel 11 support by @mokhosh in https://github.com/spatie/laravel-sluggable/pull/271

New Contributors

• @mokhosh made their first contribution in https://github.com/spatie/laravel-sluggable/pull/271

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.5.0...3.6.0

What's Changed

• Bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/250
• Fix badge with build status in README.md by @gomzyakov in https://github.com/spatie/laravel-sluggable/pull/252
• Bump dependabot/fetch-metadata from 1.3.6 to 1.4.0 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/255
• feat: add findBySlug alias by @IsraelOrtuno in https://github.com/spatie/laravel-sluggable/pull/256

New Contributors

• @gomzyakov made their first contribution in https://github.com/spatie/laravel-sluggable/pull/252
• @IsraelOrtuno made their first contribution in https://github.com/spatie/laravel-sluggable/pull/256

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.4.2...3.5.0

• update for Laravel 10

What's Changed

• Update README.md by @furiouskj in https://github.com/spatie/laravel-sluggable/pull/240
• composer allow-plugins config by @hotsaucejake in https://github.com/spatie/laravel-sluggable/pull/241
• Normalize composer.json by @patinthehat in https://github.com/spatie/laravel-sluggable/pull/247
• Add Dependabot Automation by @patinthehat in https://github.com/spatie/laravel-sluggable/pull/246
• Add PHP 8.2 Support by @patinthehat in https://github.com/spatie/laravel-sluggable/pull/245
• Bump actions/checkout from 2 to 3 by @dependabot in https://github.com/spatie/laravel-sluggable/pull/248
• Allow set slug suffix starting number by @Vediovis in https://github.com/spatie/laravel-sluggable/pull/249

New Contributors

• @furiouskj made their first contribution in https://github.com/spatie/laravel-sluggable/pull/240
• @hotsaucejake made their first contribution in https://github.com/spatie/laravel-sluggable/pull/241
• @dependabot made their first contribution in https://github.com/spatie/laravel-sluggable/pull/248
• @Vediovis made their first contribution in https://github.com/spatie/laravel-sluggable/pull/249

Full Changelog: https://github.com/spatie/laravel-sluggable/compare/3.4.0...3.4.1

• support Laravel 9

• add extra scope callback option (#201)

• bugfix for updating slugs generated from a callback (#200)

• update slug on non unique names (#195)

• require PHP 8+
• drop support for PHP 7.x
• convert syntax to PHP 8
• move Exceptions to Exceptions folder to match structure of other packages

• Added translatable slug overriding (#190)

• fix Eloquent model checking (#186)

• add preventOverwrite
• add support for PHP 8

• fixed an incompatibility bug with postgresql uuid column (#173)

• add support for Laravel 8

• add helper trait to integrate with laravel-translatable #155

• fix bug that causes empty slugs when dealing with multi-bytes chars (#152)

• use method for retrieving incrementing status of the model (#151)

• add support for Laravel 7, drop support for Laravel 6

• drop support for anything below PHP 7.4 and Laravel 6

• Changed: Updated Laravel 6 compatibility for future versions

• Drop support for PHP 7.1
• Add support for Laravel 6.0

• ensure slugs are unique when using soft deletes

• Add support for Laravel 5.8

• performance improvements

• improve compatibility with json fields

• add support for Laravel 5.7

• fix for models with non incrementing primary keys

• Support Laravel 5.6

• improve compatibility with Lumen

• add usingLanguage

• add support for Laravel 5.5, drop support for all older versions of the framework

• make compatible with PHP 7.2

• fix bugs when using a custom separator

• add usingSeparator()

• ignore global scopes when determining a unique slug

• add support for Laravel 5.4

• add doNotGenerateSlugsOnCreate and doNotGenerateSlugsOnUpdate

• Added the ability to generate slugs from a callable

• Allow custom slugs

• Fix bug when creating slugs from null values

• Fix Postgres bug

• Initial release