README

¡Ándale! ¡Ándale! ¡Arriba! ¡Arriba! ¡Epa! ¡Epa! ¡Epa! Yeehaw!

"Gosh, yet another micro-framework for timing PHP code.." you might say. I can deal with that. Almost.

Installation

$  composer require "lx/gonzalez" "dev-master"

Usage

Setup


<?php

use \Gonzalez\Runner

require_once 'vendor/autoload.php';

$function_to_benchmark = function() {
    // code to benchmark goes here...
};

$runner = new Runner($function_to_benchmark);

Basics

$results = $runner->run(1000);

$iterations = count($results);
$overall_time = array_sum($results);

$fastest = min($results);
$slowest = max($results);
$average = $iterations / $overall_time;

Calibration

Why?

Let's say you want to measure how fast you can drink a pint of beer. Let's also say you have only one arm. The steps it would take are:

Press Start in the stopwatch app in your shiny smartphone
Put your smartphone on the desk
Grab the glass
Drink
Put down the glass
Grab your smartphone
Press Stop in the stopwatch app in your shiny smartphone
Burp

What you wanted to measure was only action #4, what you actually measured was action #2 to #7. Not good.

How?

Gonzalez provides a simple way to calibrate your benchmarks: Gonzalez.

The minimum calibration you want to do is the time it takes php entering and leaving the function to benchmark. So if you want to benchmark an anonymous function you would take an empty anonymous function:

$empty_anonymous_function = function () {};
$calibrator = new Runner($empty_anonymous_function);

$result = $calibrator->run(10000);
$calibration_time = min($result);

$runner->setCalibrationTime($calibration_time);

$result = $runner->run(1000);
// ...

In general your calibration function should be exactly the same as the function you want to benchmark, excluding the lines of code you really want to benchmark.

lx / gonzalez

Maintainers

Details