Server Timing Middleware

Latest Version Software License Build Status HHVM Status Coverage

This middleware implements the Server-Timing header for displaying server side timing information on Chrome DevTools.


Install using Composer:

$ composer require tuupola/server-timing-middleware


Example below assumes you are using Slim. Note that ServerTiming must be added as last middleware. Otherwise timings will be inaccurate.

By default the middleware adds three timings:

  1. Bootstrap is the time taken from start of the request to execution of the first incoming middleware
  2. Process is the time taken for server to generate the response and process the middleware stack
  3. Total is the total time taken

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\ServerTiming;
use Tuupola\Middleware\ServerTiming\Stopwatch;

$app = new \Slim\App;
$container = $app->getContainer();

$container["stopwatch"] = function ($container) {
    return new Stopwatch;

$container["ServerTiming"] = function ($container) {
    return new ServerTiming($container["stopwatch"]);

$container["DummyMiddleware"] = function ($container) {
    return function ($request, $response, $next) {
        return $next($request, $response);


$app->get("/test", function (Request $request, Response $response) {
    $this->stopwatch->start("External API");
    $this->stopwatch->stop("External API");

    $this->stopwatch->closure("Magic", function () {

    $this->stopwatch->set("SQL", 34);

    return $response;

$ curl --include

HTTP/1.1 200 OK
Date: Tue, 07 Mar 2017 11:58:57 +0000
Connection: close
X-Powered-By: PHP/7.1.2
Content-Type: text/html; charset=UTF-8
Server-Timing: Bootstrap=0.008, externalapi=0.103; "External API", Magic=0.051, SQL=0.034, Process=0.396, Total=0.405
Content-Length: 0

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 ServerTiming 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);


/* Use your Doctrine DBAL connection here. */


You can run tests either manually:

$ composer test

Or automatically on every code change. This requires entr to work:

$ composer watch


Please see CONTRIBUTING for details.


If you discover any security related issues, please email [email protected] instead of using the issue tracker.


The MIT License (MIT). Please see License File for more information.