Blocks referral spam using middleware for Laravel 5.5+

1.5 2023-01-30 22:13 UTC

This package is auto-updated.

Last update: 2023-11-29 02:02:16 UTC


Latest Stable Version Total Downloads License

Middleware for Laravel 5.5+ that blocks referrer spam using a list from Matomo.


Require this package with composer:

composer require dougsisk/laravel-block-referral-spam

After updating composer, add the DougSisk\BlockReferralSpam\Middleware\BlockReferralSpam to your web middleware group in app/Http/Kernel.php or any others you wish to use:

protected $middlewareGroups = [
    'web' => [


By default, the list of domains to block will be loaded from vendor/matomo/referrer-spam-list/spammers.txt. This is under the assumption your vendor folder is installed in the base path of your app. If your vendor folder is not in your base path or you wish to use a custom list file, add the following line to your config/app.php:

'referral_spam_list_location' => base_path('my-folder/my-list.txt'),

Please remember to follow the formatting in the original list file should you make your own custom list.


This library is available under the MIT license.