rafahsborges/laravel-page-speed

Laravel Page Speed

2.1.3 2023-09-29 14:49 UTC

This package is auto-updated.

Last update: 2024-09-29 16:54:58 UTC


README

Laravel Page Speed logo

Build Status Latest Stable Version Total Downloads License

Laravel Page Speed

一个简单的包,可以按需压缩HTML输出,从而实现35%以上的优化。Laravel Page Speed 由 Rafael Souza Borges 创建,并由 João Roberto P. BorgesLucas Mesquita BorgesRafael Souza Borges 维护。

安装

需求

您可以通过composer安装此包

composer require rafahsborges/laravel-page-speed

此包支持Laravel 包发现

发布配置文件

php artisan vendor:publish --provider="RafahSBorges\LaravelPageSpeed\ServiceProvider"

不要忘记注册中间件

接下来,需要在kernel中注册以下中间件 \RafahSBorges\LaravelPageSpeed\Middleware\CollapseWhitespace::class 和其他中间件,例如

//app/Http/Kernel.php

protected $middleware = [
    ...
    \RafahSBorges\LaravelPageSpeed\Middleware\InlineCss::class,
    \RafahSBorges\LaravelPageSpeed\Middleware\ElideAttributes::class,
    \RafahSBorges\LaravelPageSpeed\Middleware\InsertDNSPrefetch::class,
    \RafahSBorges\LaravelPageSpeed\Middleware\RemoveComments::class,
    //\RafahSBorges\LaravelPageSpeed\Middleware\TrimUrls::class, 
    //\RafahSBorges\LaravelPageSpeed\Middleware\RemoveQuotes::class,
    \RafahSBorges\LaravelPageSpeed\Middleware\CollapseWhitespace::class, // Note: This middleware invokes "RemoveComments::class" before it runs.
    \RafahSBorges\LaravelPageSpeed\Middleware\DeferJavascript::class,
]

中间件详情

\RafahSBorges\LaravelPageSpeed\Middleware\RemoveComments::class

RemoveComments::class 过滤器通过删除注释消除了HTML、JS和CSS注释。该过滤器通过删除注释来减少HTML文件的传输大小。根据HTML文件的不同,此过滤器可以显著减少网络上传输的字节数。

\RafahSBorges\LaravelPageSpeed\Middleware\CollapseWhitespace::class

CollapseWhitespace::class 过滤器通过删除不必要的空白来减少HTML文件中传输的字节数。此中间件在执行之前调用 RemoveComments::class 过滤器。

注意:不要与它一起注册 "RemoveComments::class" 过滤器。因为它将由 "CollapseWhitespace::class" 自动调用。

之前

Before of Laravel Page Speed

之后

After of Laravel Page Speed

\RafahSBorges\LaravelPageSpeed\Middleware\RemoveQuotes::class

RemoveQuotes::class 过滤器消除了HTML属性中的不必要的引号。虽然各种HTML规范要求使用引号,但浏览器允许在某些字符子集(字母数字和某些标点符号)组成的属性值中省略引号。

引号删除在大多数页面上的字节数节省上产生适度节省。

\RafahSBorges\LaravelPageSpeed\Middleware\ElideAttributes::class

ElideAttributes::class 过滤器通过从标签中删除属性来减少HTML文件的传输大小,当指定的值等于该属性的默认值时。这可以节省一定数量的字节,并可能通过规范化受影响的标签来使文档更具可压缩性。

\RafahSBorges\LaravelPageSpeed\Middleware\InsertDNSPrefetch::class

InsertDNSPrefetch::class 过滤器在HEAD中注入标签,使浏览器能够进行DNS预取。

DNS解析时间从本地缓存的结果的 <1ms,到由于DNS的级联性质而造成数百毫秒。这可以显著地影响总页面加载时间。此过滤器通过在HTML开头提供提示来减少DNS查找时间,允许浏览器预先解析页面上的资源。

⚠️ \RafahSBorges\LaravelPageSpeed\Middleware\TrimUrls::class,

TrimUrls::class 过滤器通过将它们解析为相对于页面基本URL的相对URL来修剪URL。

警告TrimUrls::class 被视为 中等风险。如果它使用了错误的基URL,则可能会出现问题。例如,如果您提供将被原封不动地粘贴到其他HTML页面中的HTML,则可能会发生这种情况。如果第一页上的URL被修剪,则它们将不适合插入的页面。在这种情况下,只需禁用中间件即可。

\RafahSBorges\LaravelPageSpeed\Middleware\InlineCss::class

InlineCss::class 过滤器将标签的行内 "style" 属性转换为类,通过将 CSS 移动到头部来实现。

\RafahSBorges\LaravelPageSpeed\Middleware\DeferJavascript::class

延迟 HTML 中的 JavaScript 执行。

如果需要在某些脚本中取消延迟,请使用 data-pagespeed-no-defer 作为脚本属性来取消延迟。

配置

安装包后,您可能需要配置一些选项。

禁用服务

您可能想要设置本地环境以获得可读的输出。

//config/laravel-page-speed.php

//Set this field to false to disable the laravel page speed service.
'enable' => env('LARAVEL_PAGE_SPEED_ENABLE', true),

跳过路由

您可能希望配置该包以跳过一些路由。

//config/laravel-page-speed.php

//You can use * as wildcard.
'skip' => [
    '*.pdf', //Ignore all routes with final .pdf
    '*/downloads/*',//Ignore all routes that contain 'downloads'
    'assets/*', // Ignore all routes with the 'assets' prefix
];

默认情况下,此字段已配置了一些选项,因此请根据您的需求进行配置...

注意:此包自动跳过 'binary' 和 'streamed' 响应。请参阅 文件下载

测试

$ composer test

贡献

请参阅 CONTRIBUTING 了解详细信息。

贡献者

灵感

Mod Page Speed (https://www.modpagespeed.com/)

许可证

MIT 许可证(MIT)。请参阅 许可证文件 了解更多信息。