rafahsborges / laravel-page-speed
Laravel Page Speed
Requires
- php: ^8.0
- illuminate/support: ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0
Requires (Dev)
- mockery/mockery: ^1.4
- orchestra/testbench: ^4.0 || ^5.0 || ^6.0 || ^7.0
- phpunit/phpunit: ^8.5 || ^9.0
- squizlabs/php_codesniffer: ^3.6
This package is auto-updated.
Last update: 2024-09-29 16:54:58 UTC
README
Laravel Page Speed
一个简单的包,可以按需压缩HTML输出,从而实现35%以上的优化。Laravel Page Speed 由 Rafael Souza Borges 创建,并由 João Roberto P. Borges、Lucas Mesquita Borges 和 Rafael 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" 自动调用。
之前
之后
\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)。请参阅 许可证文件 了解更多信息。