CI框架源码阅读笔记5 基准测试 BenchMark.php
这个组件结构较简单，只有一个marker内部变量和三个对外的接口：
1 Elapsed_time
2 Mark
3 Memory_usage
下面一个个展开来看：
1. mark
函数的签名为：
function mark($name)
这个函数接受一个string类型的参数，而实现更简单，只有一句话：
$this->marker[$name] = microtime();
也就是说这个函数只是用于记录函数调用时刻的时间点。
值得注意的是，由于Controller中的特殊处理（之后我们会详细解释），你的应用程序控制器中可以使用$this->benchmark->mark($name);的方式来添加运行的时间点，例如：
$this->benchmark->mark("function_test_start");
$this->_test();
$this->benchmark->mark("function_test_end");
print_r($this->benchmark);
其中,function_test_start和function_test_end分别用于记录函数调用开始和结束的时间点
打印出的结果：
现在要计算函数的调用时间，需要用到BenchMark组件的第二个函数elapsed_time
2. elapsed_time
函数的签名为：
function elapsed_time($point1 = '', $point2 = '', $decimals = 4)
3个参数均为可选参数
(1). 如果$point1 为空，则返回’{elapsed_time}’
if ($point1 == '') {
return '{elapsed_time}';
}
纳尼！明明应该返回的是时间，怎么反而返回的是字符串，而且这么奇怪（类似smarty的标签）。其实，在Output组件中，{elapsed_time}会被替换，我们暂时看一下替换的方式：
$elapsed = $BM->elapsed_time('total_execution_time_start', 'total_execution_time_end');
$output = str_replace('{elapsed_time}', $elapsed, $output);
也就是说，没有指定参数的情况下，调用该函数实际得到的是total_execution_time_start这个时间点到total_execution_time_end这个时间点的时间差。更进一步，由于total_execution_time_start是在BM加载之后设置的第一个mark点（total_execution_time_end并未定义，返回的是当前时间点），该函数返回的实际就是系统的加载和运行时间。
(2).如果调用的是未知的mark点。则结果是未知的，直接返回空：
if ( ! isset($this->marker[$point1]))
{
return '';
}
(3).如果没有设置$point2的mark点，则将$point2的mark点设置为当前的时间点。
if ( ! isset($this->marker[$point2]))
{
$this->marker[$point2] = microtime();
}
(4).最后返回的两个mark点的时间差：
list($sm, $ss) = explode(' ', $this->marker[$point1]);
list($em, $es) = explode(' ', $this->marker[$point2]);
return number_format(($em + $es) - ($sm + $ss), $decimals);
还看之前的例子，这里我们可以通过调用：
echo $this->benchmark->elapsed_time("function_test_start","function_test_end");
得到函数的执行时间.
3. memory_usage
这个函数返回的是系统的内存使用情况（MB单位），与{elapsed_time} 一样，这个函数返回的{memory_usage}也会在Output中被替换：
$memory = ( ! function_exists('memory_get_usage')) ? '0' : round(memory_get_usage()/1024/1024, 2).'MB';
$output = str_replace('{memory_usage}', $memory, $output);
由于BenchMark组件本身较简单，我们不做更多的解释。
最后，贴上这个组件的源码：
复制代码
<?php
class CI_Benchmark {
/**
* List of all benchmark markers and when they were added
*
* @var array
*/
var $marker = array();
/**
* Set a benchmark marker
*
* @access public
* @param string $name name of the marker
* @return void
*/
function mark($name)
{
$this->marker[$name] = microtime();
}
/**
* Calculates the time difference between two marked points.
* If the first parameter is empty this function instead returns the {elapsed_time} pseudo-variable. This permits the full system
* @access public
* @param string a particular marked point
* @param string a particular marked point
* @param integer the number of decimal places
* @return mixed
*/
function elapsed_time($point1 = '', $point2 = '', $decimals = 4)
{
if ($point1 == '')
{
return '{elapsed_time}';
}
if ( ! isset($this->marker[$point1]))
{
return '';
}
if ( ! isset($this->marker[$point2]))
{
$this->marker[$point2] = microtime();
}
list($sm, $ss) = explode(' ', $this->marker[$point1]);
list($em, $es) = explode(' ', $this->marker[$point2]);
return number_format(($em + $es) - ($sm + $ss), $decimals);
}
/**
* Memory Usage
* This function returns the {memory_usage} pseudo-variable.
*/
function memory_usage()
{
return '{memory_usage}';
}
}