CI框架源码阅读笔记5 基准测试 BenchMark.php，cibenchmark.php-php手册-PHP中文網

CI框架源码阅读笔记5 基准测试 BenchMark.php，cibenchmark.php

　　上一篇博客（CI框架源码阅读笔记4 引导文件CodeIgniter.php）中，我们已经看到：CI中核心流程的核心功能都是由不同的组件来完成的。这些组件类似于一个一个单独的模块，不同的模块完成不同的功能，各模块之间可以相互调用，共同构成了CI的核心骨架。

　　从本篇开始，将进一步去分析各组件的实现细节，深入CI核心的黑盒内部（研究之后，其实就应该是白盒了，仅仅对于应用来说，它应该算是黑盒），从而更好的去认识、把握这个框架。

　　按照惯例，在开始之前，我们贴上CI中不完全的核心组件图：

　　由于BenchMark是CI中第一个加载的core组件，因此我们的分析首先从该组件开始。BenchMark的含义非常明确，使用过BenchMark工具的同学应该比较清楚，这是一个基准组件。既然是BenchMark，我们便可大胆猜想，BM组件的主要功能就是记录程序的运行时间、内存使用、cpu使用等情况。

先看类图:

这个组件结构较简单，只有一个marker内部变量和三个对外的接口：

<span>1</span> <span>Elapsed_time
</span><span>2</span> <span>Mark
</span><span>3</span> Memory_usage

登入後複製

下面一个个展开来看：

1.　　mark

函数的签名为：

<span>function</span> mark(<span>$name</span>)

登入後複製

这个函数接受一个string类型的参数，而实现更简单，只有一句话：

<span>$this</span>->marker[<span>$name</span>] = <span>microtime</span>();

登入後複製

也就是说这个函数只是用于记录函数调用时刻的时间点。

值得注意的是，由于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

函数的签名为：

<span>function</span> elapsed_time(<span>$point1</span> = '', <span>$point2</span> = '', <span>$decimals</span> = 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);

登入後複製

还看之前的例子，这里我们可以通过调用：

<span>echo</span> <span>$this</span>->benchmark->elapsed_time("function_test_start","function_test_end");

登入後複製

得到函数的执行时间.

3.　　memory_usage

这个函数返回的是系统的内存使用情况（MB单位），与{elapsed_time} 一样，这个函数返回的{memory_usage}也会在Output中被替换：

<span>$memory</span>  = ( ! <span>function_exists</span>('memory_get_usage')) ? '0' : <span>round</span>(memory_get_usage()/1024/1024, 2).'MB'<span>;
</span><span>$output</span> = <span>str_replace</span>('{memory_usage}', <span>$memory</span>, <span>$output</span>);

登入後複製

由于BenchMark组件本身较简单，我们不做更多的解释。

最后，贴上这个组件的源码：

<?<span>php

</span><span>class</span><span> CI_Benchmark {

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

    </span><span>/*</span><span>*
     * Set a benchmark marker
     *
     * @access    public
     * @param    string    $name    name of the marker
     * @return    void
     </span><span>*/</span>
    <span>function</span> mark(<span>$name</span><span>)
    {
        </span><span>$this</span>->marker[<span>$name</span>] = <span>microtime</span><span>();
    }

    </span><span>/*</span><span>*
     * 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
     </span><span>*/</span>
    <span>function</span> elapsed_time(<span>$point1</span> = '', <span>$point2</span> = '', <span>$decimals</span> = 4<span>)
    {
        </span><span>if</span> (<span>$point1</span> == ''<span>)
        {
            </span><span>return</span> '{elapsed_time}'<span>;
        }

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

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

        </span><span>list</span>(<span>$sm</span>, <span>$ss</span>) = <span>explode</span>(' ', <span>$this</span>->marker[<span>$point1</span><span>]);
        </span><span>list</span>(<span>$em</span>, <span>$es</span>) = <span>explode</span>(' ', <span>$this</span>->marker[<span>$point2</span><span>]);

        </span><span>return</span> <span>number_format</span>((<span>$em</span> + <span>$es</span>) - (<span>$sm</span> + <span>$ss</span>), <span>$decimals</span><span>);
    }

    </span><span>/*</span><span>*
     * Memory Usage
     * This function returns the {memory_usage} pseudo-variable.
     </span><span>*/</span>
    <span>function</span><span> memory_usage()
    {
        </span><span>return</span> '{memory_usage}'<span>;
    }

}</span>

登入後複製