andrey-helldar/spammers

Simple package to prevent accessing of spammers to Laravel application

Spammers for Laravel 5.4+

Simple package to prevent accessing of spammers to Laravel application., _(*1)

, _(*2)

, _(*3)

Installation

To get the latest version of this package, simply require the project using Composer:, _(*4)

$ composer require andrey-helldar/spammers

Instead, you may of course manually update your require block and run composer update if you so choose:, _(*5)

{
    "require": {
        "andrey-helldar/spammers": "^1.0"
    }
}

If you don't use auto-discovery, add the ServiceProvider to the providers array in config/app.php:, _(*6)

Helldar\Spammers\ServiceProvider::class,

Next, call php artisan vendor:publish and php artisan migrate commands after set up config/spammers.php file and install the migrations by running php artisan migrate command., _(*7)

Now, use spammer() helper and Artisan commands., _(*8)

Documentation

• Helpers Store
• Helpers Accessing
• Middleware
• Console Command
• Additional
• Simple Using

Helpers Store

Store IP-address in a spam-table:, _(*9)

spammer()
    ->ip('1.2.3.4')
    ->store();

// or

spammer('1.2.3.4')->store();

Delete IP-address from a spam-table:, _(*10)

spammer()
    ->ip('1.2.3.4')
    ->delete();

// or

spammer('1.2.3.4')->delete();

Restore IP-address from a spam-table:, _(*11)

spammer()
    ->ip('1.2.3.4')
    ->restore();

// or

spammer('1.2.3.4')->restore();

Check exists IP-address in a spam-table:, _(*12)

spammer()
    ->ip('1.2.3.4')
    ->exists();

// or

spammer('1.2.3.4')->exists();

Helpers Accessing

To save an IP address with the URL in the database, use the helper spammer()->access():, _(*13)

spammer()
    ->access()
    ->ip('1.2.3.4')
    ->url('/foo/bar')
    ->store();

// or

spammer('1.2.3.4')
    ->access()
    ->url('/foo/bar')
    ->store();

Ban when attempts to get pages with errors exceed a given number., _(*14)

Example:, _(*15)

• When the number of attempts reaches 100 - ban for 24 hours.
• When the number of attempts reaches 300 - ban for 72 hours.
• When the number of attempts reaches 500 - permanent ban.

Default, permanent ban., _(*16)

Middleware

Next, add link to middleware in $routeMiddleware block in app/Http/Kernel.php file, and use him in $middlewareGroups blocks:, _(*17)

protected $middlewareGroups = [
    'web' => [
        // ...
        'spammers'
    ],

    'api' => [
        // ...
        'spammers'
    ],
];

protected $routeMiddleware = [
    // ...
    'spammers' => Helldar\Spammers\Middleware\Spammers::class
];

Or you can specify globally in the attribute $middleware of the Http/Kernel.php file:, _(*18)

protected $middleware = [
    // ...
    \Helldar\Spammers\Middleware\Spammers::class,    
];

Console Command

This package maybe called in a console:, _(*19)

spam:amnesty
spam:store 1.2.3.4
spam:delete 1.2.3.4
spam:restore 1.2.3.4
spam:exists 1.2.3.4

The spam:amnesty command allows you to delete IP-addresses that have expired., _(*20)

Additional

You can use a Helldar\Spammers\Models\Spammer model. His extended Illuminate\Database\Eloquent\Model., _(*21)

Simple Using

You can specify globally in the attribute $middleware of the Http/Kernel.php file:, _(*22)

protected $middleware = [
    // ...
    \Helldar\Spammers\Middleware\Spammers::class,    
];

Next, in the report() method of file app\Exceptions\Handler.php, add the call to the spammer()->access() helper:, _(*23)

public function report(Exception $exception)
{
    spammer(request()->ip())
        ->access()
        ->url(request()->fullUrl())
        ->store();

    parent::report($exception);
}

And add a rule to the schedule() method of the app/Console/Kernel.php file:, _(*24)

protected function schedule(Schedule $schedule)
{
    $schedule->command('spam:amnesty')
        ->everyThirtyMinutes();
}

Execute the commands:, _(*25)

php artisan vendor:publish
php artisan migrate

Customize the file config/spammers.php for your purposes., _(*26)

Profit!, _(*27)

Copyright and License

Laravel Spammers was written by Andrey Helldar for the Laravel framework 5.4 or later, and is released under the MIT License. See the LICENSE file for details., _(*28)

Translation

Translations of text and comment by Google Translate. Help with translation +1 in karma :), _(*29)