orkhanahmadov / laravel-ip-middleware
Laravel middleware for whitelisting/blacklisting client IP addresses
Installs: 46 395
Dependents: 0
Suggesters: 0
Security: 0
Stars: 24
Watchers: 2
Forks: 9
Open Issues: 1
Requires
- php: ^8.0
- illuminate/contracts: ^8.0|^9.0|^10.0|^11.0
- illuminate/http: ^8.0|^9.0|^10.0|^11.0
- illuminate/support: ^8.0|^9.0|^10.0|^11.0
Requires (Dev)
- orchestra/testbench: ^5.0|^6.0|^7.0
- phpunit/phpunit: ^8.0|^9.0|^10.0
README
Laravel middleware for whitelisting/blacklisting client IP addresses
Requirements
- PHP 8.0 or higher
- Laravel 8 or higher
Installation
You can install the package via composer:
composer require orkhanahmadov/laravel-ip-middleware
Usage
Packages comes with WhitelistMiddleware
and BlacklistMiddleware
middlewares.
You can register any or both of them in $routeMiddleware
in app/Http/Kernel.php
file:
protected $routeMiddleware = [ // ... 'ip_whitelist' => \Orkhanahmadov\LaravelIpMiddleware\WhitelistMiddleware::class, 'ip_blacklist' => \Orkhanahmadov\LaravelIpMiddleware\BlacklistMiddleware::class, ];
Use middlewares in any of your routes and pass IP addresses.
Route::middleware('ip_whitelist:1.1.1.1')->get('/', 'HomeController@index'); Route::middleware('ip_blacklist:3.3.3.3')->get('/', 'PostController@index');
ip_whitelist
middleware will block any requests where client IP not matching with whitelisted IPs.ip_blacklist
middleware will block requests coming from blacklisted IPs.
You can also pass multiple IP addresses separated with comma:
Route::middleware('ip_whitelist:1.1.1.1,2.2.2.2')->get('/', 'HomeController@index');
This will block all requests where client IP not matching whitelisted IP list.
Package also allows setting predefine IP list in config and use them with name:
// config/ip-middleware.php 'predefined_lists' = [ 'my-list-1' => ['1.1.1.1', '2.2.2.2'], 'my-list-2' => ['3.3.3.3', '4.4.4.4'], ];
Route::middleware('ip_whitelist:my-list-1,my-list-2')->get('/', 'HomeController@index'); // you can also mix predefined list with additional IP addresses Route::middleware('ip_whitelist:my-list-1,my-list-2,5.5.5.5,6.6.6.6')->get('/', 'PostController@index');
Configuration
Run this command to publish package config file:
php artisan vendor:publish --provider="Orkhanahmadov\LaravelIpMiddleware\LaravelIpMiddlewareServiceProvider"
ip-middleware.php
config file contains following settings:
ignore_environments
- Middleware ignores IP checking when application is running in listed environments.error_code
- HTTP code that shown when request gets rejected.custom_server_parameter
- Custom $_SERVER parameter to look for IP addresspredefined_lists
- Predefined IP lists
Testing
composer test
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email ahmadov90@gmail.com instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.