Skip to content
master
Switch branches/tags
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
May 15, 2020
src
Aug 26, 2020
May 15, 2020
May 15, 2020
May 15, 2020
May 28, 2020

README.md

Laravel RickRoll

CI StyleCI License Last Version

Redirects people trying to break your site to Never Gonna Give You Up, from Rick Astley. This package is inspired by Liam Hammett's tweet.

Getting started

You can install the package via composer, if you don't have composer, you can download it here:

composer require felixdorn/laravel-rickroll

Or by adding a requirement in your composer.json :

{
    "require": {
        "felixdorn/laravel-rickroll": "dev-master"
    }
}

We need your knowledge!

Do you know any well-known url that "hackers" try to break a site ? Add these here in the $urls array, and submit a PR, thanks!

Usage

On your routes/web.php just add this single line, and we'll handle the rest for you!

use Felix\Rickroll\Facades\RickRoll;

RickRoll::routes();

Redirecting to a custom URL

use Felix\Rickroll\Facades\RickRoll;

RickRoll::routes()->redirectsTo('https://mycustom.url');

Remove all URLs

use Felix\Rickroll\Facades\RickRoll;

RickRoll::routes()->clear();

Adding a URL

use Felix\Rickroll\Facades\RickRoll;

RickRoll::routes()->push('/rickroll')
    ->push('/rickroll/{id}', [
        'id' => '[0-9]+'
    ]);

Helper

There is a rickroll function available if you want to rickroll someone in one of your controllers.

rickroll($dispatchEvent = true, 'https://my-custom.url');

You don't need to return anything, it works just like an abort.

Events

We're dispatching an event with the current request when someone is rick-rolled. Just listen for Felix\RickRoll\Events\RickRolled in your EventServiceProvider .

Testing

composer test

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email hi@felixdorn.fr instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.