Benchmarking

CodeIgniter provides two separate tools to help you benchmark your code and test different options:the Timer and the Iterator. The Timer allows you to easily calculate the time between two points in theexecution of your script. The Iterator allows you to set up several variations and runs those tests, recordingperformance and memory statistics to help you decide which version is the best.

The Timer class is always active, being started from the moment the framework is invoked until right beforesending the output to the user, enabling a very accurate timing of the entire system execution.

Using the Timer

With the Timer, you can measure the time between two moments in the execution of your application. This makesit simple to measure the performance of different aspects of your application. All measurement is done usingthe start() and stop() methods.

The start() methods takes a single parameter: the name of this timer. You can use any string as the nameof the timer. It is only used for you to reference later to know which measurement is which:

  1. $benchmark = \Config\Services::timer();
  2. $benchmark->start('render view');

The stop() method takes the name of the timer that you want to stop as the only parameter, also:

  1. $benchmark->stop('render view');

The name is not case-sensitive, but otherwise must match the name you gave it when you started the timer.

Alternatively, you can use the global function timer() to startand stop timers:

  1. // Start the timer
  2. timer('render view');
  3. // Stop a running timer,
  4. // if one of this name has been started
  5. timer('render view');

Viewing Your Benchmark Points

When your application runs, all of the timers that you have set are collected by the Timer class. It doesnot automatically display them, though. You can retrieve all of your timers by calling the getTimers() method.This returns an array of benchmark information, including start, end, and duration:

  1. $timers = $benchmark->getTimers();
  2.  
  3. // Timers =
  4. [
  5.         'render view'  => [
  6.                 'start'    => 1234567890,
  7.                 'end'      => 1345678920,
  8.                 'duration' => 15.4315      // number of seconds
  9.         ]
  10. ]

You can change the precision of the calculated duration by passing in the number of decimal places you want to be shown asthe only parameter. The default value is 4 numbers behind the decimal point:

  1. $timers = $benchmark->getTimers(6);

The timers are automatically displayed in the Debub Toolbar.

Displaying Execution Time

While the getTimers() method will give you the raw data for all of the timers in your project, you can retrievethe duration of a single timer, in seconds, with the getElapsedTime() method. The first parameter is the name ofthe timer to display. The second is the number of decimal places to display. This defaults to 4:

  1. echo timer()->getElapsedTime('render view');
  2. // Displays: 0.0234

Using the Iterator

The Iterator is a simple tool that is designed to allow you to try out multiple variations on a solution tosee the speed differences and different memory usage patterns. You can add any number of “tasks” for it torun and the class will run the task hundreds or thousands of times to get a clearer picture of performance.The results can then be retrieved and used by your script, or displayed as an HTML table.

Creating Tasks To Run

Tasks are defined within Closures. Any output the task creates will be discarded automatically. They areadded to the Iterator class through the add() method. The first parameter is a name you want to refer tothis test by. The second parameter is the Closure, itself:

  1. $iterator = new \CodeIgniter\Benchmark\Iterator();
  2.  
  3. // Add a new task
  4. $iterator->add('single_concat', function()
  5.         {
  6.                 $str = 'Some basic'.'little'.'string concatenation test.';
  7.         }
  8. );
  9.  
  10. // Add another task
  11. $iterator->add('double', function($a='little')
  12.         {
  13.                 $str = "Some basic {$little} string test.";
  14.         }
  15. );

Running the Tasks

Once you’ve added the tasks to run, you can use the run() method to loop over the tasks many times.By default, it will run each task 1000 times. This is probably sufficient for most simple tests. If you needto run the tests more times than that, you can pass the number as the first parameter:

  1. // Run the tests 3000 times.
  2. $iterator->run(3000);

Once it has run, it will return an HTML table with the results of the test. If you don’t want the resultsdisplayed, you can pass in false as the second parameter:

  1. // Don't display the results.
  2. $iterator->run(1000, false);