vlados/laravel-unique-urls

A package for using and generating unique urls for each Eloquent model in Laravel

v2.1.0 2026-02-12 11:52 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^11.0|^12.0
• spatie/laravel-model-info: ^2.0
• spatie/laravel-package-tools: ^1.9.2
• spatie/laravel-translatable: ^6.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.8
• larastan/larastan: ^3.0
• nunomaduro/collision: ^8.0
• nunomaduro/phpinsights: ^2.4
• orchestra/testbench: ^9.0|^10.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-faker: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/extension-installer: ^1.1
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpunit: ^11.0
• spatie/laravel-ray: ^1.26

MIT

• Vladislav Stoitsov

• laravel
• vlados
• laravel-unique-urls

README

Generate unique, prefix-free URLs for any Eloquent model — blogs, e-commerce, multi-language platforms.

PHP 8.2+ | Laravel 11, 12

Features

• Auto-trim slashes to prevent 404 errors
• Multi-language URLs (distinct slugs per locale, not just prefixes)
• Automatic redirects when URLs change (301 by default)
• Hierarchical URLs via parent relationships (e.g. category/product)
• Livewire full-page component support (FQCN and SFC names)
• Batch generation with progress tracking for large datasets
• Slug validation and reserved-slug protection
• urls:doctor command for configuration health checks

Installation

composer require vlados/laravel-unique-urls
php artisan vendor:publish --tag="laravel-unique-urls-migrations"
php artisan migrate

Quick Start

Add the trait to your model and define how URLs are built:

use Vlados\LaravelUniqueUrls\HasUniqueUrls;

class Product extends Model
{
    use HasUniqueUrls;

    public function urlStrategy($language, $locale): string
    {
        return Str::slug($this->name, '-', $locale);
    }

    public function urlHandler(): array
    {
        return [
            'controller' => ProductController::class,
            'method'     => 'view',
            'arguments'  => [],
        ];
    }
}

Register the catch-all route at the end of routes/web.php:

Route::get('{urlObj}', [\Vlados\LaravelUniqueUrls\LaravelUniqueUrlsController::class, 'handleRequest'])
    ->where('urlObj', '.*');

Access URLs on any model instance:

$product->relative_url;  // "my-product"
$product->absolute_url;  // "https://example.com/my-product"
$product->getSlug('en'); // slug for a specific language

Documentation

• Configuration — config options and defaults
• Usage — model setup, routes, multi-language, Livewire
• Bulk Operations — batch generation, global toggles, performance
• Artisan Commands — urls:generate and urls:doctor
• Testing — assertion helpers and example tests
• Troubleshooting — common issues and fixes

Changelog

See CHANGELOG.md for release history.

Contributing

This project follows Conventional Commits.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Vladislav Stoitsov
• All Contributors

License

The MIT License (MIT). See LICENSE.md for details.