Download the PHP
package mattitjaab/bad-ip-blocker without Composer
On this page you can find all versions of the php package
mattitjaab/bad-ip-blocker. It is possible to download/install
these versions without Composer. Possible dependencies are resolved
automatically.
Vendor mattitjaab Package bad-ip-blocker Short Description Block IPs based on a remote JSON file. License
MIT
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Block incoming requests from known bad IP addresses using a centralized JSON feed.
This package fetches a list of bad IPs from a remote API hosted by Mattitja AB and caches them locally. Requests from matching IPs are immediately blocked with a 418 response.
Features
Automatically blocks known malicious IPs
Pulls IP list from a centralized JSON endpoint
Caches data locally to avoid repeated API calls
Designed to run globally across all routes
Installation
Usage
Register as global middleware in Laravel 12
Edit bootstrap/app.php:
This ensures the middleware runs globally on every incoming request.
How it works
On each request, the middleware checks if the client's IP exists in a cached JSON file.
If the cache is missing or older than one hour, it attempts to refresh from https://bad-ip.mattitja.cloud/api/json.
If the IP is found in the list, the request is blocked with a 418 response.
Cache location
Cached data is stored using Laravel's Cache facade (default: file driver):
To clear the cache and force a refresh:
Or clear all cache:
Example response when blocked
Maintained by Mattitja AB
This package is maintained by Mattitja AB and is intended for internal use across multiple projects.
Composer command for our command line client (download client)This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free.Standard composer command
The package mattitjaab/bad-ip-blocker contains the following files
Loading the files please wait ...
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.