akankov/laravel-compress-html

Laravel integration for the akankov/html-min HTML minifier: Blade @htmlmin directive, response middleware, and a publishable config-driven service provider.

v0.2.0 2026-05-07 20:03 UTC

Requires

• php: 8.3.* || 8.4.* || 8.5.*
• akankov/html-min: ^2.5
• illuminate/contracts: ^11.0 || ^12.0 || ^13.0
• illuminate/http: ^11.0 || ^12.0 || ^13.0
• illuminate/support: ^11.0 || ^12.0 || ^13.0
• illuminate/view: ^11.0 || ^12.0 || ^13.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.65
• larastan/larastan: ^3.0
• orchestra/testbench: ^9.0 || ^10.0 || ^11.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.1
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpunit: ^11.0 || ^12.0 || ^13.0
• rector/rector: ^2.0

MIT

• Aleksei Kankov

• html
• minify
• compress
• middleware
• laravel
• blade
• html-min

README

laravel-compress-html

Laravel integration for akankov/html-min — adds a Blade @htmlmin block directive, an opt-in HTML response middleware, and a publishable config-driven service provider.

Requirements

• PHP 8.3.* || 8.4.* || 8.5.*
• Laravel 11.x, 12.x, or 13.x
• akankov/html-min ^2.5

Install

composer require akankov/laravel-compress-html

The service provider is registered automatically via Laravel's package auto-discovery (extra.laravel.providers in composer.json); no manual config/app.php edit is needed.

Optionally publish the config file to tune the 29 minifier toggles:

php artisan vendor:publish --tag=htmlmin-config

This drops config/htmlmin.php into your application — every key defaults to the engine's default, so you only need to edit the ones you want to flip.

Blade directive

@htmlmin
<div>
    <p>{{ $user->name }}</p>
</div>
@endhtmlmin

The block captures rendered output, then minifies it. Variables interpolated via {{ $expr }} are escaped by Blade before the buffer reaches the minifier, so it's safe to interpolate user data inside.

Response middleware

Opt-in: the service provider does not push the middleware onto the global stack — register it explicitly where you want it.

Globally, in bootstrap/app.php (Laravel 11+):

use Akankov\LaravelCompressHtml\Http\MinifyHtmlResponseMiddleware;
use Illuminate\Foundation\Configuration\Middleware;

return Application::configure(basePath: dirname(__DIR__))
    // …
    ->withMiddleware(function (Middleware $middleware): void {
        $middleware->append(MinifyHtmlResponseMiddleware::class);
    })
    // …
    ->create();

Or per-route / per-group:

use Akankov\LaravelCompressHtml\Http\MinifyHtmlResponseMiddleware;

Route::middleware(MinifyHtmlResponseMiddleware::class)
    ->group(function (): void {
        // routes whose responses should be minified
    });

The middleware only touches Illuminate\Http\Response instances whose Content-Type first segment is text/html. JSON, streamed, and binary responses pass through unchanged.

Configuration

Every key in config/htmlmin.php is a snake_case mirror of a property on Akankov\HtmlMin\Config\MinifierOptions. The provider converts them with Str::camel() when constructing the options object, so:

'remove_comments'    => true,    // → MinifierOptions::$removeComments
'sum_up_whitespace'  => true,    // → MinifierOptions::$sumUpWhitespace
'optimize_attributes' => true,   // → MinifierOptions::$optimizeAttributes

See the published config file for the full list of 29 keys with their defaults.

Tests

composer install
vendor/bin/phpunit
make ci   # cs-check + phpstan + rector-check + test

License

MIT