esign / laravel-redirects
A laravel package to control redirects from the database or other sources.
Installs: 2 069
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 4
Forks: 1
Open Issues: 0
Requires
- php: ^8.0
- illuminate/database: ^10.0|^11.0
- illuminate/http: ^10.0|^11.0
- illuminate/support: ^10.0|^11.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.5
- orchestra/testbench: ^8.0|^9.1
- phpunit/phpunit: ^9.0|^10.0
This package is auto-updated.
Last update: 2024-11-05 10:41:21 UTC
README
This package provides an easy way to load redirects from the database instead of defining them in your route files. By default the package will only load your redirects when the original request results in a 404.
Installation
You can install the package via composer:
composer require esign/laravel-redirects
The package will automatically register a service provider.
For the redirects to be active you must register the Esign\Redirects\Http\Middleware\CheckForRedirects
middleware.
Laravel 11+
// bootstrap/app.php ->withMiddleware(function (Middleware $middleware) { $middleware->append(Esign\Redirects\Http\Middleware\CheckForRedirects::class); })
Older versions (up to Laravel 10)
// app/Http/Kernel.php protected $middleware = [ ... Esign\Redirects\Http\Middleware\CheckForRedirects::class, ];
This package comes with a migration to store your redirects. In case you want to modify this migration you may publish it using:
php artisan vendor:publish --provider="Esign\Redirects\RedirectsServiceProvider" --tag="migrations"
Next up, you can publish the configuration file:
php artisan vendor:publish --provider="Esign\Redirects\RedirectsServiceProvider" --tag="config"
The config file will be published as config/redirects.php
with the following content:
return [ /** * This is the model used by the DatabaseRedirector. * It should implement the RedirectContract interface and extend the Model class. */ 'redirect_model' => Esign\Redirects\Models\Redirect::class, /** * This class provides the redicect url's to the CheckForRedirects middleware. * It should implement the RedirectorContract interface. */ 'redirector' => Esign\Redirects\Redirectors\DatabaseRedirector::class, 'cache' => [ /** * The key that will be used to cache the redirects. */ 'key' => 'esign.laravel-redirects.redirects', /** * The duration for which database redirects will be cached. */ 'ttl' => \DateInterval::createFromDateString('24 hours'), /** * The cache store to be used for database redirects. * Use null to utilize the default cache store from the cache.php config file. * To disable caching, you can use the 'array' store. */ 'store' => null, ], ];
Usage
Defining redirects in the database is pretty straight forward:
Redirect::create([ 'old_url' => 'my-old-url', 'new_url' => 'my-new-url', ]);
It's also possible to define route parameters just like the way you're used to in Laravel:
Redirect::create([ 'old_url' => 'my-old-url/{slug}', 'new_url' => 'my-new-url/{slug}', ]);
When using route parameters, the following parameters are reserved by Laravel and cannot be used: destination
and status
.
You may even swap the order of the route parameters
Redirect::create([ 'old_url' => 'my-old-url/{slug}/{year}', 'new_url' => 'my-new-url/{year}/{slug}', ]);
By default a 302
status will be used, but you can also supply a custom status code
Redirect::create([ 'old_url' => 'my-old-url/{slug}/{year}', 'new_url' => 'my-new-url/{year}/{slug}', 'status_code' => 301, ]);
It's also possible to redirect to external urls
Redirect::create([ 'old_url' => 'my-old-url', 'new_url' => 'https://www.esign.eu', ]);
This package also allows you to define constraints for your routes:
Redirect::create([ 'old_url' => 'user/{id}', 'new_url' => 'users/{id}', 'constraints' => ['id' => '[0-9]+'], ]); Redirect::create([ 'old_url' => 'nl/{any?}', 'new_url' => 'nl-be/{any?}', 'constraints' => ['any' => '.*'], ]);
This package also ships with a DatabaseWildcardRedirector
, which allows you to define redirects by using *
as a wildcard. This will automatically apply a constraint to match any trailing url segments:
Redirect::create([ 'old_url' => 'my-old-url/*', 'new_url' => 'my-new-url/*', ]);
Caching redirects
By default, this package ensures efficient performance by caching your database redirects for 24 hours. This caching mechanism uses the default cache driver that you have configured within your Laravel application.
If you wish to modify the cache duration or switch to a different cache store, please refer to the cache settings within the configuration file.
Clearing the redirects cache
The redirects cache is automatically maintained when you interact with the Esign\Redirects\Models\Redirect
model.
However, if you make changes outside of these operations, you need to manually clear the cache:
php artisan redirects:clear-cache
Testing
composer test
License
The MIT License (MIT). Please see License File for more information.