# antonioribeiro/firewall

Firewall package for Laravel applications

Repository: https://github.com/antonioribeiro/firewall
Canonical: https://ross.abutalabs.com/products/firewall
Language: PHP
License: BSD-3-Clause
License Family: permissive
Topics: firewall, attack-prevention, laravel, php, attack-detection
Last push: 2023-02-17T12:06:34+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4641, "days_push": 1293, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1405, forks 174 (observed 2026-08-28T04:04:38.162444+00:00)

## What it is
A Laravel package acting as a soft-firewall that controls route access by IP address, country, or host via blacklists and whitelists. It also detects and blocks attacks such as excessive requests from single IPs or countries, with optional Slack notifications.

## Use cases
- block requests from specific IP addresses or countries in Laravel
- whitelist my office IP and redirect everyone else to a coming soon page
- detect and block too many requests from a single IP
- protect admin routes with an IP blacklist middleware
- whitelist a developer machine with a dynamic DNS hostname
- get Slack alerts when an attack is detected

## When to choose
- you run a Laravel app and need application-level IP-based access control
- you want simple attack detection and blocking at the HTTP request layer
- you need country- or range-based whitelisting/blacklisting with middleware

## When to avoid
- you need network-level firewalling or DDoS protection - use a real firewall or WAF
- your project is not Laravel/PHP
- you need actively maintained security tooling - the latest release is from 2023

## Facets
- artifact type: library
- maturity: maintenance
- function: security, middleware, rate-limiting, routing
- domain: security, web-development, backend
- platform: php, self-hosted
- tags: laravel, ip-blocking, whitelist, blacklist, attack-detection, soft-firewall, web-server

## Member repositories
- antonioribeiro/firewall (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:38.162444+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:38:46.575699+00:00, confidence not recorded.
  - readme: https://github.com/antonioribeiro/firewall (fetched 2026-08-28T04:04:38.162444+00:00, sha 95f8cfca3b82)
- Data as of 2026-08-30T08:39:29.467469+00:00.