Imagine you are working on a new app. Your client wants to see the progress that you've made. However your site isn't ready for prime time yet. Sure, you could create some login functionality and display the site only to logged in users. But why bother creating users when there is a more pragmatic approach?
This package provides a route middleware to protected routes from prying eyes. All users that visit a protocted route will be redirect to a configurable url (e.g. /under-construction
). To view the content of the routes a visitor must first visit a url that grants access (e.g. /demo
).
A word to the wise: do not use this package to restrict access to sensitive data or to protect an admin section. For those cases you should use proper authentication.
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
You're free to use this package (it's MIT-licensed), but if it makes it to your production environment you are required to send us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.
The best postcards will get published on the open source page on our website.
You can install the package via composer:
$ composer require spatie/laravel-demo-mode
Next up, the service provider must be registered:
'providers' => [
...
Spatie\DemoMode\DemoModeServiceProvider::class,
];
The \Spatie\DemoMode\DemoMode::class
-middleware must be registered in the kernel:
//app/Http/Kernel.php
protected $routeMiddleware = [
...
'demoMode' => \Spatie\DemoMode\DemoMode::class,
];
Naming the route middleware DemoMode
is just a suggestion. You can give it any name you'd like.
You must publish the config file:
php artisan vendor:publish --provider="Spatie\DemoMode\DemoModeServiceProvider"
This is the content of the published config file laravel-demo-mode.php
:
return [
/**
* This is the master switch to enable demo mode.
*/
'enabled' => env('DEMO_MODE_ENABLED', true),
/**
* Visitors that go an url that is protected by demo mode will be redirected.
* to this url
*/
'redirect_unauthorized_users_to_url' => '/under-construction',
/**
* After have been granted access visitors will be redirected to this url.
*/
'redirect_authorized_users_to_url' => '/',
];
In your routes file you must call the demoAccess
route macro.
Route::demoAccess('/demo');
Visiting /demo
will grant access to the pages protected by demo mode. Of course you can choose any url you'd like.
You can protect some routes by using the demoMode
-middleware on them.
//only users who have previously visited "/demo" will be able to see these pages.
Route::group(['middleware' => 'demoMode'], function () {
Route::get('/secret-route', function() {
echo 'Hi!';
});
});
Unless you visit the url used by the demoAccess
route macro first, visiting these routes will result in a redirect in to the url specified in the redirect_unauthorized_users_to_url
-key of the config file.
An authenticated user has access to all protected routes too.
Please see CHANGELOG for more information what has changed recently.
$ composer test
Please see CONTRIBUTING for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
The MIT License (MIT). Please see License File for more information.