8000 GitHub - l-x/gonzalez: Yet another micro-framework for timing PHP code
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content
This repository was archived by the owner on Aug 8, 2019. It is now read-only.

l-x/gonzalez

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
< 8000 /td>
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gonzalez

¡Á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:

  1. Press Start in the stopwatch app in your shiny smartphone
  2. Put your smartphone on the desk
  3. Grab the glass
  4. Drink
  5. Put down the glass
  6. Grab your smartphone
  7. Press Stop in the stopwatch app in your shiny smartphone
  8. 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.


Bunch'o'Badges

Build Status Test Coverage Code Climate License Badges

About

Yet another micro-framework for timing PHP code

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
0