Download the PHP package linups/linups-firewall without Composer

On this page you can find all versions of the php package linups/linups-firewall. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

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.
Please rate this library. Is it a good library?

Informations about the package linups-firewall

linups-firewall

Laravel package that blocks web crawlers. Every request URL is matched against the keywords table; a match returns 403, stores the client IP in banned_ips and adds it to a Cloudflare IP list (which you reference from a Cloudflare WAF rule).

Installation

The middleware is registered globally by the service provider. It is also available as the linups-firewall route middleware alias.

Configuration (.env)

Key Purpose
cloudflare_api_token Scoped API token (Account Filter Lists: Edit). Recommended.
cloudflare_auth_email, cloudflare_auth_key Legacy Global API Key auth, used only when no token is set.
cloudflare_account_id, cloudflare_list_id Target IP list.
cloudflare_endpoint Defaults to https://api.cloudflare.com/client/v4/accounts.
notification_email Receives the 404 notifications. Empty = off. Banned crawlers are not mailed.
not_found_notification true to mail notification_email about every 404 (URL, time, request details) with an Add url to ban list link. Default off.
not_found_throttle_minutes Report the same URL at most once per this many minutes, default 60. 0 = every hit.
ban_link_expires_days Validity of the signed Add url to ban list link, default 7.
ban_duration_days Local ban retention, default 30.
sync_with_main_project enabled to download keywords from another installation.
sync_project_endpoint Base URL of that installation.
keyword_list_token Shared secret protecting /linups-firewall/v1/get-keyword-list. Set the same value on both sides.

404 notifications

With not_found_notification=true, each 404 sends a mail containing a link to /linups-firewall/ban-url. The page needs no login: the link is a signed URL that expires after ban_link_expires_days, so it cannot be forged or edited. The form is pre-filled with the requested path, which you can shorten before saving it to the keywords table. Signed links rely on APP_KEY. Only the path and query are signed, so the link keeps working behind Cloudflare or a load balancer even without trusted proxies.

Scheduled commands

Command Time Action
clear:old-banned-ip 03:03 Delete bans older than ban_duration_days.
update:banned-ips-on-cloudflare 04:06 Replace the Cloudflare list with the local bans (IPv6 as /64).
sync:Keywords 05:09 Import keywords from the main project.

Testing

All versions of linups-firewall with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
illuminate/console Version ^9.0|^10.0|^11.0|^12.0|^13.0
illuminate/database Version ^9.0|^10.0|^11.0|^12.0|^13.0
illuminate/http Version ^9.0|^10.0|^11.0|^12.0|^13.0
illuminate/support Version ^9.0|^10.0|^11.0|^12.0|^13.0
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 linups/linups-firewall contains the following files

Loading the files please wait ...