#native_company# #native_desc#

Timing Script Execution Page 2

By Allan Kent
on September 26, 2000

Getting Clever

The problem with the previous script is that what happens when you want to find exactly which part of your script is taking all the time? You have to move the start time and end time bits around all over the script and write down the results, comparing notes and invariably losing half the little bits of paper you wrote them down on. What if we want to create markers all the way through our script and see the time it takes between each marker? Sounds like a lot code to add into our scripts, so what I did instead was create a timer object, which we could use to time our scripts.

The timer object

Our object will only need one property – an array of the times that we have marked parts of the script. I also added in a descriptor for the time. Our object will have to have a number of methods – a method to start the timer, a method to stop the timer and a method to add markers for any points in between. We will also need a method to display the information that we have collected. Because I found that a lot the code was being duplicated, I created a function to join the times together.
Here then is the code for the include file phptimer.inc. I’ve added comments through the code as explanation, but if you are happy with arrays and understand a bit of OO programming, you should have no worries:


// begin class PHP_timer

class PHP_timer {

    // array to store the information that we collect during the script

    // this array will be manipulated by the functions within our object

var $points = array();


// call this function at the beginning of the script

function start() {

// see the addmarker() function later on



// end function start()

    // call this function at the end of the script

    function stop() {

// see the addmarker() function later on



// end function stop()

    // this function is called to add a marker during the scripts execution

    // it requires a descriptive name

    function addmarker($name) {

// call the jointime() function and pass it the output of the microtime() function

        //  as an argument

$markertime $this->jointime(microtime());

// $ae (stands for Array Elements) will contain the number of elements 

        // currently in the $points array

$ae count($this->points);

// store the timestamp and the descriptive name in the array

$this->points[$ae][0] = $markertime;

$this->points[$ae][1] = $name;


// end function addmarker()

    // this function manipulates the string that we get back from the microtime() function

    function jointime($mtime) {

// split up the output string from microtime() that has been passed

        // to the function

$timeparts explode(' ',$mtime);

// concatenate the two bits together, dropping the leading 0 from the

        // fractional part

$finaltime $timeparts[1].substr($timeparts[0],1);

// return the concatenated string

return $finaltime;


// end function jointime()


    // this function simply give the difference in seconds betwen the start of the script and

    // the end of the script

function showtime() {



// end function showtime()


    // this function displays all of the information that was collected during the 

    // course of the script

function debug() {

'Script execution debug information:';

"<table border="0" cellspacing="5" cellpadding="5">n";

// the format of our table will be 3 columns:

        // Marker name, Timestamp, difference

echo "<tr><td><b>Marker</b></td><td><b>Time</b></td><td><b>Diff</b></td></tr>n";

// the first row will have no difference since it is the first timestamp

echo "<tr>n";





// our loop through the $points array must start at 1 rather than 0 because we have

        // already written out the first row

for ($i 1$i count($this->points);$i++) {





// write out the difference between this row and the previous row

echo bcsub($this->points[$i][0],$this->points[$i-1][0],6);






// end function debug()


// end class PHP_timer