在 Laravel 应用开发过程中，性能问题常常困扰着开发者。响应时间过长，页面加载缓慢，这些都会严重影响用户体验。然而，传统的性能分析方法往往效率低下，难以快速定位问题所在。幸运的是，beyondcode/laravel-server-timing 扩展包为我们提供了一个强大的解决方案，它可以帮助我们轻松地在浏览器开发者工具中添加 Server-Timing 头部信息，从而精准地分析应用性能，找出瓶颈所在。
Composer在线学习地址：学习地址beyondcode/laravel-server-timing 扩展包通过在 HTTP 响应中添加 Server-Timing 头部信息，将服务器端的性能指标暴露给浏览器开发者工具。这样，开发者可以直接在浏览器中查看各个阶段的耗时，例如：
- Bootstrap: Laravel 应用启动所花费的时间。
- Application: 应用处理请求并生成响应所花费的时间。
- Total: 整个请求处理过程的总耗时。
除了以上默认的指标外，你还可以自定义更多的性能指标，例如数据库查询时间、视图渲染时间等等，从而更全面地了解应用的性能状况。
安装
使用 Composer 安装非常简单：
composer require beyondcode/laravel-server-timing
配置
安装完成后，你需要将 \BeyondCode\ServerTiming\Middleware\ServerTimingMiddleware::class 中间件添加到你的 HTTP Kernel 中。为了获得最准确的结果，建议将其添加到中间件栈的最前面。
-
Laravel 11:
bootstrap/app.phpreturn Application::configure(basePath: dirname(__DIR__)) // ... ->withMiddleware(function (Middleware $middleware) { $middleware->prepend(\BeyondCode\ServerTiming\Middleware\ServerTimingMiddleware::class); }) // ... ->create(); -
Laravel 10 及以下版本:
app/Http/Kernel.phpclass Kernel extends HttpKernel { protected $middleware = [ \BeyondCode\ServerTiming\Middleware\ServerTimingMiddleware::class, // ... ]; }
使用
安装并配置完成后，你就可以在浏览器开发者工具的 "Network" 面板中看到 Server-Timing 头部信息了。
添加自定义指标
你可以使用 ServerTiming::start() 和 ServerTiming::stop() 方法来添加自定义的性能指标：
use BeyondCode\ServerTiming\Facades\ServerTiming;
ServerTiming::start('Database Query');
// 执行数据库查询
DB::table('users')->get();
ServerTiming::stop('Database Query');如果你已经知道某个操作的耗时，可以使用 ServerTiming::setDuration() 方法：
ServerTiming::setDuration('Cache Retrieval', 200); // 耗时 200 毫秒你还可以传递一个闭包给 ServerTiming::setDuration() 方法，它会自动测量闭包的执行时间：
ServerTiming::setDuration('Image Processing', function() {
// 执行图像处理操作
sleep(1); // 模拟耗时操作
});添加文本信息
除了性能指标外，你还可以使用 ServerTiming::addMetric() 方法添加文本信息，例如用户信息、请求参数等等：
ServerTiming::addMetric('User ID: ' . Auth::id());优势和实际应用效果
- 精准定位性能瓶颈： 通过 Server-Timing 头部信息，你可以清晰地了解应用各个阶段的耗时，从而快速定位性能瓶颈。
- 简化性能分析流程： 无需复杂的性能分析工具，直接在浏览器开发者工具中即可查看性能数据，简化了性能分析流程。
- 实时监控应用性能： 可以在开发和生产环境中实时监控应用性能，及时发现并解决潜在的性能问题。
- 提高开发效率： 快速定位性能瓶颈，可以减少调试时间，提高开发效率。
beyondcode/laravel-server-timing 是一款非常实用的 Laravel 扩展包，它可以帮助你轻松地分析应用性能，找出瓶颈所在，从而优化你的 Laravel 应用，提升用户体验。如果你正在为 Laravel 应用的性能问题而烦恼，不妨试试这款扩展包，相信它会给你带来惊喜。
