tuupola / server-timing-middleware
PSR-7 and PSR-15 server timing middleware
Installs: 72 998
Dependents: 2
Suggesters: 0
Security: 0
Stars: 198
Watchers: 8
Forks: 10
Open Issues: 8
Requires
- php: ^7.1|^8.0
- psr/http-server-middleware: ^1.0
- symfony/stopwatch: ^4.0|^5.0|^6.0
- tuupola/callable-handler: ^1.0
Requires (Dev)
- doctrine/dbal: ^2.0
- equip/dispatch: ^2.0
- laminas/laminas-diactoros: ^2.4
- overtrue/phplint: ^0.2.0
- phpstan/phpstan: ^0.12.45
- phpunit/phpunit: ^7.0|^8.0|^9.0
- psr/http-message: ^1.0.1
- squizlabs/php_codesniffer: ^3.5
- tuupola/http-factory: ^1.0
Suggests
- doctrine/dbal: If you want to use the DBAL query timer.
This package is auto-updated.
Last update: 2024-11-15 18:21:19 UTC
README
This middleware implements the Server-Timing header which can be used for displaying server side timing information on Chrome DevTools.
Install
Install using Composer:
$ composer require tuupola/server-timing-middleware
Simple usage
To get the default timings add the middleware to the pipeline. With Zend Expressive this goes go to the file named config/pipeline.php
.
use Tuupola\Middleware\ServerTimingMiddleware; $app->pipe(ServerTimingMiddleware::class);
Slim Framework does not have specific config files. Otherwise adding the middleware is similar with previous.
$app->add(new Tuupola\Middleware\ServerTimingMiddleware);
You should now see the default timings when doing a request.
Bootstrap
is the time taken from start of the request to execution of the first incoming middlewareProcess
is the time taken for server to generate the response and process the middleware stackTotal
is the total time taken
$ curl --include http://localhost:8080
HTTP/1.1 200 OK
Server-Timing: Bootstrap;dur=54, Process;dur=2, Total;dur=58
Note that ServerTimingMiddleware
must be added as last middleware. Otherwise timings will be inaccurate.
Changing the defaults
If you are not happy with the above you can change the description by using an optional settings array. To disable any of the defaults set the description to null
.
use Tuupola\Middleware\ServerTimingMiddleware; use Tuupola\Middleware\ServerTiming\Stopwatch; $app->add(new ServerTimingMiddleware( new Stopwatch, [ "bootstrap" => "Startup", "process" => null, "total" => "Sum" ]) );
$ curl --include http://localhost:8080
HTTP/1.1 200 OK
Server-Timing: Startup;dur=52, Sum;dur=57
Advanced usage
Example below uses Slim Framework. Note again that ServerTimingMiddleware
must be added as last middleware. Otherwise timings will be inaccurate.
You can add your own timings by using the Stopwatch
instance. See example below.
require __DIR__ . "/vendor/autoload.php"; use Psr\Http\Message\ServerRequestInterface as Request; use Psr\Http\Message\ResponseInterface as Response; use Tuupola\Middleware\ServerTimingMiddleware; use Tuupola\Middleware\ServerTiming\Stopwatch; $app = new Slim\App; $container = $app->getContainer(); $container["stopwatch"] = function ($container) { return new Stopwatch; }; $container["ServerTimingMiddleware"] = function ($container) { return new ServerTimingMiddleware($container["stopwatch"]); }; $container["DummyMiddleware"] = function ($container) { return function ($request, $response, $next) { usleep(200000); return $next($request, $response); }; }; $app->add("DummyMiddleware"); $app->add("ServerTimingMiddleware"); $app->get("/test", function (Request $request, Response $response) { $this->stopwatch->start("External API"); usleep(100000); $this->stopwatch->stop("External API"); $this->stopwatch->closure("Magic", function () { usleep(50000); }); $this->stopwatch->set("SQL", 34); return $response; }); $app->run();
$ curl --include http://0.0.0.0:8080/test
HTTP/1.1 200 OK
Server-Timing: Bootstrap;dur=9, externalapi;dur=101;desc="External API", Magic;dur=50, SQL;dur=34, Process;dur=360, Total;dur=369
Usage with Doctrine DBAL
If you use Doctrine DBAL you can automate SQL query timings by using the provided QueryTimer
. It implements the DBAL SQLLogger
interface and can be used as standalone or in a LoggerChain
. You must use the same Stopwatch
instance with both QueryTimer
and ServerTimingMiddleware
middleware.
use Doctrine\DBAL\Logging\EchoSQLLogger; use Doctrine\DBAL\Logging\LoggerChain; use Tuupola\Middleware\ServerTiming\QueryTimer; use Tuupola\Middleware\ServerTiming\Stopwatch; $logger = new LoggerChain; $echo = new EchoSQLLogger; $stopwatch = new Stopwatch; $timer = new QueryTimer($stopwatch); $logger->addLogger($echo); $logger->addLogger($timer); /* Use your Doctrine DBAL connection here. */ $connection->getConfiguration()->setSQLLogger($logger);
Testing
You can run tests either manually or automatically on every code change. Automatic tests require entr to work.
$ make test
$ brew install entr $ make watch
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email tuupola@appelsiini.net instead of using the issue tracker.
License
The MIT License (MIT). Please see License File for more information.