phpwatch/laravel-fast404

A Laravel middleware to quickly terminate Page-Not-Found pages that do not require a full HTML page

v1.0.0 2020-05-20 17:16 UTC

This package is auto-updated.

Last update: 2024-10-21 03:27:44 UTC


README

Laravel Fast 404

Laravel Fast 404

Laravel Fast 404 is a Laravel package that adds a global middleware to your Laravel application to immediately terminate HTTP(s) requests for non-HTML 404 requests. This prevents unnecessary database connections and your application from fully bootstrapping to serve an HTML page that nobody will see.

This is done by inspecting every incoming HTTP request's "Accept" header and the URI path. If the URI path ends with a known static file extension (such as .jpg, .png, .woff, etc), and the Accept header does not mention text/html (which is the case when browsers request images, web fonts, JS files, CSS files, etc), the request is immediately terminated by this middleware.

Latest Stable Version Total Downloads License CI

Requirements

  • Laravel 5.5+, 6, or 7
  • PHP 7.4

Installation

composer require phpwatch/laravel-fast404

Upon installation, Laravel will automatically register the Service Provider bundled with this package, which will in turn register middleware and the Fast404Middleware service automatically.

Configuration

You can configure the message, the regular expression used to match URI patterns (e.g. a list of file extensions), and optionally an exclusion regular expression.

From configuration files

Update your config/app.php file, and add the following configuration to the existing array:

<?php
return [
    // ...
    'fast404' => [
        'message' => 'Not Found',
        'regex' => '',
        'exclude_regex' => '',
    ],
];

All configuration values must be strings.

File type extensions

The default regular expression is:

/\.(?:js|css|jpg|jpeg|gif|png|webp|ico|exe|bin|dmg|woff|woff2)$/i

This creates a non-capturing group of file types separated by the pipe (|) symbol above.

By updating the service provider (advanced)

This package bundles a Service Provider that conveniently enables middleware. You can turn this feature off if you wish to configure the middleware to your liking.

Step 1: Remove the automatic provider discovery for this library

In your root composer.json file, add/merge configuration directives:

{
    "extra": {
        "dont-discover": [
            "phpwatch/laravel-fast404"
        ]
    }
}

Step 2: Add the middleware

In your application App/Http/Kernel.php file, prepend the Middleware provided by this package.

<?php
class Kernel extends HttpKernel
{
    //
    protected $middleware = [
        \PHPWatch\LaravelFast404\Fast404Middleware::class,
        // other middleware
    ];
    // ...
}

Make sure to add \PHPWatch\LaravelFast404\Fast404Middleware::class, to the top because middlewares are run in the order they are declared.

Optional step 3: Register a service provider for further customizations

If you would like to configure the middleware to change the message, file extensions, or the exclusion pattern, you will need to register it in the Service Container.

To do so, you can either create a new service provider, or update an existing one to declare how the \PHPWatch\LaravelFast404\Fast404Middleware class is instantiated.

// at the top
use PHPWatch\LaravelFast404\Fast404Middleware;



// in register() method:
$this->app->bind(Fast404Middleware::class, static function ($app): Fast404Middleware {
          return new Fast404Middleware('Not Found', '/\.(?:js|css|jpg|jpeg|gif|png|webp|ico|exe|bin|dmg|woff|woff2)$/i');
        });

Contributions

Contributions are welcome! Please feel free to send a PR or open an issue. Please note that this Laravel package is in the same line as phpwatch/fast404 and phpwatch/wordpress-fast404 packages, and the extensions list updates will be made to all packages in a framework-agnostic way.