How antonioribeiro/firewall works
Firewall is a Laravel soft-firewall package for IP-, host-, range-, and country-based access control. A request enters through route middleware, which applies blacklist or whitelist policy through the Firewall facade/service and returns a block or redirect when required. Separate attack detection counts requests and can blacklist offenders and emit notifications. The README also documents list management, session blocking, GeoIP, and database/array/file-backed lists. Some command and session implementations are not shown, so those documented capabilities are represented without speculative call edges.
Main entry points: Firewall.php Firewall service · DataRepository.php Data repository · AttackBlocker.php Attack detector · FilterMiddleware.php Route middleware
Components 22
Request access control
- Route middleware
src/Middleware/FilterMiddleware.php - Blacklist middleware
src/Middleware/FirewallBlacklist.php - Whitelist middleware
src/Middleware/FirewallWhitelist.php - Blacklist filter
src/Filters/Blacklist.php - Whitelist filter
src/Filters/Whitelist.php
Firewall domain
- Firewall service
src/Firewall.php - Response builder
src/Support/Responder.php - IP address handling
src/Support/IpAddress.php - Service instances
src/Support/ServiceInstances.php
Lists and GeoIP
- Data repository
src/Repositories/DataRepository.php - IP list store
src/Repositories/IpList.php - Country lookup
src/Repositories/Countries.php - Attack cache
src/Repositories/Cache/Cache.php - Message repository
src/Repositories/Message.php
Attack response
- Attack middleware
src/Middleware/BlockAttacks.php - Attack detector
src/Support/AttackBlocker.php - Attack event
src/Events/AttackDetected.php - Admin notifier
src/Listeners/NotifyAdmins.php - Notification dispatch
src/Notifications/Notification.php - Slack channel
src/Notifications/Channels/Slack.php - Mail channel
src/Notifications/Channels/Mail.php
Other components
- HTTP client
Connections 25
- HTTP client → Route middleware: sends request
readme.md - Route middleware → Blacklist middleware: dispatches to
src/Middleware/FirewallBlacklist.php - Route middleware → Whitelist middleware: dispatches to
src/Middleware/FirewallWhitelist.php - Blacklist middleware → Blacklist filter: applies
src/Middleware/FirewallBlacklist.php - Whitelist middleware → Whitelist filter: applies
src/Middleware/FirewallWhitelist.php - Blacklist filter → Firewall service: checks list
src/Filters/Blacklist.php - Whitelist filter → Firewall service: checks whitelist
src/Filters/Whitelist.php - Whitelist filter → Response builder: builds response
src/Filters/Whitelist.php - Firewall service → Data repository: delegates list operations
src/Firewall.php - Firewall service → Response builder: builds block response
src/Firewall.php - Data repository → IP list store: delegates list operations
src/Repositories/DataRepository.php - Data repository → Country lookup: looks up countries
src/Repositories/DataRepository.php - Data repository → IP address handling: validates addresses
src/Repositories/DataRepository.php - Firewall service → Attack detector: checks attack state
src/Firewall.php - Attack middleware → Firewall service: checks attack
src/Middleware/BlockAttacks.php - Attack detector → Attack cache: stores request counts
src/Support/AttackBlocker.php - Attack detector → Firewall service: blacklists offenders
src/Support/AttackBlocker.php - Attack detector → Attack event: emits event
src/Support/AttackBlocker.php - Attack event → Admin notifier: notifies listener
src/Listeners/NotifyAdmins.php - Admin notifier → Notification dispatch: creates notification
src/Listeners/NotifyAdmins.php - Notification dispatch → Slack channel: dispatches channel
src/Notifications/Notification.php - Notification dispatch → Mail channel: dispatches channel
src/Notifications/Notification.php - Attack detector → Response builder: builds attack response
src/Support/AttackBlocker.php - Service instances → Data repository: resolves binding
src/Repositories/DataRepository.php - Data repository → IP list store: supports configured list sources
readme.md