stolz / laravel-html-tidy
HTML Tidy middleware for Laravel
Installs: 8 670
Dependents: 1
Suggesters: 0
Security: 0
Stars: 27
Watchers: 3
Forks: 6
Open Issues: 2
Requires
- php: >=5.4
- ext-tidy: *
- illuminate/http: ^5|^6|^7
- illuminate/support: ^5|^6|^7
Requires (Dev)
This package is auto-updated.
Last update: 2024-11-26 09:10:39 UTC
README
tl;dr
Laravel-html-tidy is a Laravel middleware that parses Laravel's Response objects in order to detect and fix markup problems as well as to improve the layout and indent style of the resulting markup.
How it works
When editing HTML it's easy to make mistakes. Did you ever forget to close a <div>
tag that made a mess of all your layout and then you went crazy trying to figure out what/where the problem was?. Wouldn't it be nice if there was a simple way to detect and fix these mistakes automatically and at the same time tidy up sloppy editing into nicely layed out markup? Well that is what W3C HTML Tidy utility is for!. HTML Tidy is available as an official PHP extension and this package makes using it with Laravel a breeze.
Once the middleware is enabled every time there is a problem with your HTML code you will see an error messages on your screen. Tidy will try its best to fix the problem for you. Also, if you take a look of the final HTML code sent to the browser you will get a pleasant surprise.
Note: HTML Tidy is fast but parsing output always adds a small overhead so consider using the middleware only in development environments.
Requirements
- PHP compiled with HTML Tidy support and Tidy extension enabled in php.ini.
- Laravel framework.
Installation
Install via composer
composer require stolz/laravel-html-tidy --dev
If you are using an old version of Laravel without the package discovery feature (or if you have disabled it), then you have to manually edit config/app.php
file and add the service provider to the providers
array:
'providers' => [
...
'Stolz\HtmlTidy\ServiceProvider',
],
The default settings can validate both (x)HTML 4 and HTML 5 markups. If you want to customize the settings create the file config/tidy.php
by running
php artisan vendor:publish --provider='Stolz\HtmlTidy\ServiceProvider'
Usage
If you want the middleware to be run only on specific routes, add the class in the $routeMiddleware
property of your app/Http/Kernel.php
file, with your desired short-hand key.
protected $routeMiddleware = [
...
'tidy' => 'Stolz\HtmlTidy\Middleware',
];
Now you can use it in your routes.php
file
Route::get('some/url', function () {...})->middleware('tidy');
Conversely if you want the middleware to be run on every HTTP request to your application, add the class in the $middleware
property of your app/Http/Kernel.php
file.
protected $middleware = [
...
'Stolz\HtmlTidy\Middleware',
];
Laravel 4
If you are still using Laravel 4 instead of loading Stolz\HtmlTidy\ServiceProvider
use Stolz\HtmlTidy\LegacyServiceProvider
and then in your routes.php
file use something like this
// Register filter
Route::filter('tidy', function($route, $request, $response) {
return app('stolz.tidy')->handle($request, $response);
});
// Use as an 'after' filter
Route::get('/', ['after' => 'tidy', function() {
return View::make('home');
}]);
License
MIT License © Stolz
Read the provided LICENSE
file for details.