MediaWiki 1.17.0

[autoinstallsdev/mediawiki.git] / maintenance / benchmarks / Benchmarker.php

diff --git a/maintenance/benchmarks/Benchmarker.php b/maintenance/benchmarks/Benchmarker.php
new file mode 100644 (file)
index 0000000..66789ea
--- /dev/null
+++ b/maintenance/benchmarks/Benchmarker.php
@@ -0,0 +1,72 @@
+<?php
+/**
+ * Create a doxygen subgroup of Maintenance for benchmarks
+ * @defgroup Benchmark Benchmark
+ * @ingroup Maintenance
+ */
+
+/**
+ * TODO: report PHP version, OS ..
+ * @file
+ * @ingroup Benchmark
+ */
+
+require_once( dirname( __FILE__ ) . '/../Maintenance.php' );
+abstract class Benchmarker extends Maintenance {
+       private $results;
+
+       public function __construct() {
+               parent::__construct();
+               $this->addOption( 'count', "How many time to run a benchmark", false, true );
+       }
+
+       public function bench( array $benchs ) {
+               $bench_number = 0;
+               $count = $this->getOption( 'count', 100 );
+
+               foreach( $benchs as $bench ) {
+                       // handle empty args
+                       if(!array_key_exists( 'args', $bench )) {
+                               $bench['args'] = array();
+                       }
+
+                       $bench_number++;
+                       $start = wfTime();
+                       for( $i=0; $i<$count; $i++ ) {
+                               call_user_func_array( $bench['function'], $bench['args'] );
+                       }
+                       $delta = wfTime() - $start;
+
+                       // function passed as a callback
+                       if( is_array( $bench['function'] ) ) {
+                               $ret = get_class( $bench['function'][0] ). '->' . $bench['function'][1];
+                               $bench['function'] = $ret;
+                       }
+
+                       $this->results[$bench_number] = array(
+                               'function'  => $bench['function'],
+                               'arguments' => $bench['args'], 
+                               'count'     => $count,
+                               'delta'     => $delta,
+                               'average'   => $delta / $count,
+                               );
+               }
+       }
+
+       public function getFormattedResults( ) {
+               $ret = '';
+               foreach( $this->results as $res ) {
+                       // show function with args
+                       $ret .= sprintf( "%s times: function %s(%s) :\n",
+                               $res['count'],
+                               $res['function'],
+                               join( ', ', $res['arguments'] )
+                       );
+                       $ret .= sprintf( "   %6.2fms (%6.2fms each)\n",
+                               $res['delta']   * 1000,
+                               $res['average'] * 1000
+                       );
+               }
+               return $ret;
+       }
+}