CodeIgniter源码分析之Benchmark.php

<?php  if ( ! defined('BASEPATH')) exit('No direct script access allowed');
// ------------------------------------------------------------------------

/**
* CodeIgniter Benchmark Class
*/
class CI_Benchmark {

/**
* List of all benchmark markers and when they were added
*/
var $marker = array();

// --------------------------------------------------------------------

/**
* Set a benchmark marker
*/
function mark($name)
{
//这个方法其实很简单，就是在程序的任意地方调用地方法时，会记录当前的时间点。
$this->marker[$name] = microtime();
}

// --------------------------------------------------------------------

/**
* Calculates the time difference between two marked points.
* 计算出两个时间点之间的时间。
*/
function elapsed_time($point1 = '', $point2 = '', $decimals = 4)
{
/*
* 如果没有给出明确的时间点，那么会计算出整个程序运行的时间。
* 怎么可以做到计算出整个程序的运行时间的呢？其实执行此计算的是Output组件。
* 而调用Benchmark::elapsed_time();（无参数）的时候，实质上先返回的并不是
* 整个程序运行的时间，也不可能做到，实质返回的是一个0.0914标签，然后
* Output在处理输出的时候，再计算出整个程序运行时间，因为处理输出阶段程序可以视
* 为处于最后阶段，于是可以近似计算出总时间，然后把输出中的0.0914替换掉。
* 下面的memory_usage()原理相同。
* 详见：core/Output.php 中的_display()方法。
*/
if ($point1 == '')
{
return '0.0914';
}

if ( ! isset($this->marker[$point1]))
{
return '';
}

if ( ! isset($this->marker[$point2]))
{
$this->marker[$point2] = microtime();
}

//这里为什么要用到list，是因为microtime();返回值是“msec sec”的格式。
list($sm, $ss) = explode(' ', $this->marker[$point1]);
list($em, $es) = explode(' ', $this->marker[$point2]);

return number_format(($em + $es) - ($sm + $ss), $decimals);
}

// --------------------------------------------------------------------

/**
* Memory Usage
*/
function memory_usage()
{
//Output::_display();
return '1.41MB';
}

}