A simple unique slug generator for the Laravel applications
devboyarif/laravel-unique-slug is a Laravel package for a simple unique slug generator for the laravel applications.
It currently has 3 GitHub stars and 8 downloads on Packagist (latest version v1.0.3).
Install it with composer require devboyarif/laravel-unique-slug.
Discover more Laravel packages by devboyarif
or browse all Laravel packages to compare alternatives.
Last updated
A simple unique slug generator for the Laravel applications
composer require devboyarif/laravel-unique-slug
Service Provider Registration
In config/app.php, add in providers array -
'providers' => [
// ...
Devboyarif\LaravelUniqueSlug\UniqueSlugServiceProvider::class,
// ...
],
Facade Class Alias Add in aliases array -
'aliases' => Facade::defaultAliases()->merge([
// ...
'UniqueSlug' => Devboyarif\LaravelUniqueSlug\Facades\UniqueSlug::class,
// ...
])->toArray(),
use Devboyarif\LaravelUniqueSlug\Facades\UniqueSlug;
Let's assume, we have in Post class, we've added slug column which is unique. Now, if we passed title and generate slug from that, then -
use App\Models\Post;
// First time create post with title Simple Post
UniqueSlug::generate(Post::class, 'Simple Post', 'slug');
// Output: simple-post
// Second time create post with title Simple Post
UniqueSlug::generate(Post::class, 'Simple Post', 'slug');
// Output: simple-post-1
// Third time create post with title Simple Post
UniqueSlug::generate(Post::class, 'Simple Post', 'slug');
// Output: simple-post-2
Let's assume separator is '' empty.
// First time create user.
UniqueSlug::generate(User::class, 'arif', 'username', ''); // arif
// Second time create user.
UniqueSlug::generate(User::class, 'arif', 'username', ''); // arif1
// Third time create user.
UniqueSlug::generate(User::class, 'arif', 'username', ''); // arif2
public function create(array $data): Category|null
{
if (empty($data['slug'])) {
$data['slug'] = UniqueSlug::generate(Category::class, $data['name'], 'slug');
}
return Category::create($data);
}
UniqueSlug::generate($model, $value, $field, $separator);
/**
* Generate a Unique Slug.
*
* @param object $model
* @param string $value
* @param string $field
* @param string $separator
*
* @return string
* @throws \Exception
*/
public function generate(
$model,
$value,
$field,
$separator = null
): string
php artisan vendor:publish devboyarif/laravel-unique-slug
return [
/*
|--------------------------------------------------------------------------
| Default slug seperator
|--------------------------------------------------------------------------
|
| This is seperator for the slug value. IF no seperator is provided then this default seperator will be used as slug
|
*/
'seperator' => '-',
/*
|--------------------------------------------------------------------------
| Slug max count limit
|--------------------------------------------------------------------------
|
| Default 100, slug will generated like test-1, test-2, test-3 ... test-100
|
*/
'max_count' => 100,
];
You're open to create any Pull request.