3 * @defgroup Benchmark Benchmark
8 * Base code for benchmark scripts.
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License along
21 * with this program; if not, write to the Free Software Foundation, Inc.,
22 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
23 * http://www.gnu.org/copyleft/gpl.html
29 require_once __DIR__
. '/../Maintenance.php';
32 * Base class for benchmark scripts.
36 abstract class Benchmarker
extends Maintenance
{
38 protected $defaultCount = 100;
40 public function __construct() {
41 parent
::__construct();
42 $this->addOption( 'count', 'How many times to run a benchmark', false, true );
45 public function bench( array $benchs ) {
46 $count = $this->getOption( 'count', $this->defaultCount
);
47 foreach ( $benchs as $key => $bench ) {
48 // Default to no arguments
49 if ( !isset( $bench['args'] ) ) {
53 // Optional setup called outside time measure
54 if ( isset( $bench['setup'] ) ) {
55 call_user_func( $bench['setup'] );
57 $start = microtime( true );
58 for ( $i = 0; $i < $count; $i++
) {
59 call_user_func_array( $bench['function'], $bench['args'] );
61 $delta = microtime( true ) - $start;
63 // Name defaults to name of called function
64 if ( is_string( $key ) ) {
67 if ( is_array( $bench['function'] ) ) {
68 $name = get_class( $bench['function'][0] ) . '::' . $bench['function'][1];
70 $name = strval( $bench['function'] );
72 $name = sprintf( "%s(%s)",
74 implode( ', ', $bench['args'] )
82 'average' => $delta / $count,
87 public function getFormattedResults() {
88 $ret = sprintf( "Running PHP version %s (%s) on %s %s %s\n\n",
95 foreach ( $this->results
as $res ) {
96 // show function with args
97 $ret .= sprintf( "%s times: %s\n",
101 $ret .= sprintf( " %6.2fms (%6.4fms each)\n",
103 $res['average'] * 1e3