The Benchmark package is now installed and ready to go. The desired extensions are made available to our script by using the require_once statement to include the appropriate file.
<?php require_once "Benchmark/Timer.php"; ?>
If PHP complains it was unable find the file, you may need to modify your php.ini file's include_path directive. Or, you can temporarily append the directory to the include path for the duration of the script by using the ini_set() function.
A new timer object is created with new Benchmark_Timer and is made accessible by assigning it to the variable $t. The object can then be manipulated by the methods start, stop and display. Intuitively, start will start the timer, stop will stop the timer and display will output the results table.
The output of the above script would resemble the following:
Hello World! ------------------------------------------------------------- marker time index ex time perct ------------------------------------------------------------- Start 1064782761.34820600 - 0.00% ------------------------------------------------------------- Stop 1064782761.34845500 0.00024890899658203 100.00% ------------------------------------------------------------- total - 0.00024890899658203 100.00% -------------------------------------------------------------
You may even set markers throughout your code to compare the execution time of various sections. This is done with the setMarker method which accepts a string to identify the marker.
<?php require_once "Benchmark/Timer.php";
$t = new Benchmark_Timer(); $t->start(); echo "Hello, World! <br />";
The benchmarking utility provided through PEAR is easy to implement and is a useful tool to examine the efficiency of your scripts... but it's also only one of many useful PEAR packages. To date over 200 packages are available through the PEAR Package Manager and are organized in various repositories.
