e107inc/e107

<?php
/*
 * e107 website system
 *
 * Copyright (C) 2008-2010 e107 Inc (e107.org)
 * Released under the terms and conditions of the
 * GNU General Public License (http://www.gnu.org/licenses/gpl.txt)
 *
 * Benchmark handler
 *
 * $URL$
 * $Id$
 */

 /**
 * @package e107
 * @subpackage e107_handlers
 * @version $Id$
 * @author secretr
 *
 * Simple, quick and efective way of testing performance of parts of your code
 * Example:
 * <code> <?php
 * require_once e_HANDLER.'benchmark.php';
 *
 * $bench = new e_benchmark();
 * $bench->start();
 *
 * // Do something, e.g. loop 1000000 times
 *
 * // stop timer and check your e_LOG folder
 * $bench->end()->logResult('myevent');
 * //OR print out the result (don't forget to stop the timer if used without the above line!
 * $bench->printResult();
 * </code>
 */
class e_benchmark
{
    protected $time_start;
    protected $time_end;

    /**
     * Constructor
     */
    function __construct()
    {
        $this->time_end = $this->time_start = 0;
    }

    /**
     * Start timer
     * @return e_benchmark
     */
    public function start()
    {
        $this->time_start = microtime(true);
        return $this;
    }

    /**
     * Stop timer
     * @return e_benchmark
     */
    public function end()
    {
        $this->time_end = microtime(true);
        return $this;
    }

    /**
     * Calculate result
     * @return integer
     */
    public function result()
    {
        return ($this->time_end - $this->time_start);
    }

    /**
     * Write result to a file in system log
     * @param string $id identifier of the current benchmark event e.g. 'thumbnail.create'
     * @param string $heading additional data to be shown in the log (header) e.g. '[Some Event]'
     * @param boolean $append overwrite or append to the log file
     * @return e_benchmark
     */
    public function logResult($id, $heading = '', $append = true)
    {
        file_put_contents(e_LOG.'Benchmark_'.$id.'.log', $this->formatData($heading), ($append ? FILE_APPEND : 0));
        return $this;
    }

    /**
     * Send result to the stdout
     *
     * @param string $heading
     * @return e_benchmark
     */
    public function printResult($heading = '')
    {
        print('<pre>'.$this->formatData($heading).'</pre>');
        return $this;
    }

    /**
     * Format data for loging/printing
     *
     * @param string $heading
     * @return string
     */
    function formatData($heading)
    {
        $data = "------------- Log Start -------------\n".date('r')." ".$heading."\n";
        $data .= "Result: ".$this->result()." sec\n------------- Log End -------------\n\n";
        return $data;
    }
}