471d2371ab
Updated Doxygen markup in several .php files triggering warnings when mwdocgen.php is executed. Removed obsolete settings MSCGEN_PATH and TCL_SUBST from Doxyfile. The former would generate a warning in 1.8.16 while TCL support was removed in 1.8.18. Since TCL_SUBST was blank anyway, it was removed prior to getting to .18 in production. Increased DOT_GRAPH_MAX_NODES from 50 to 200 since Doxygen complained about it being too low for API and Maintenance. Bug: T248706 Change-Id: I9c67f0807d1b43089d351263d4f591dee5501f36
105 lines
2.5 KiB
PHP
105 lines
2.5 KiB
PHP
<?php
|
|
/**
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
*/
|
|
|
|
/**
|
|
* Convenience class for working with XHProf
|
|
* <https://github.com/phacility/xhprof>. XHProf can be installed via PECL.
|
|
*
|
|
* This also supports using the Tideways profiler
|
|
* <https://github.com/tideways/php-xhprof-extension>.
|
|
*
|
|
* @since 1.28
|
|
*/
|
|
class Xhprof {
|
|
/**
|
|
* @var bool Whether XHProf is currently running.
|
|
*/
|
|
protected static $enabled;
|
|
|
|
/**
|
|
* Start xhprof profiler
|
|
* @return bool
|
|
*/
|
|
public static function isEnabled() {
|
|
return self::$enabled;
|
|
}
|
|
|
|
/**
|
|
* Start xhprof profiler
|
|
* @param int $flags
|
|
* @param array $options
|
|
* @throws Exception
|
|
*/
|
|
public static function enable( $flags = 0, $options = [] ) {
|
|
if ( self::isEnabled() ) {
|
|
throw new Exception( 'Profiling is already enabled.' );
|
|
}
|
|
|
|
$args = [ $flags ];
|
|
if ( $options ) {
|
|
$args[] = $options;
|
|
}
|
|
|
|
self::$enabled = true;
|
|
self::callAny(
|
|
[
|
|
'xhprof_enable',
|
|
'tideways_enable',
|
|
'tideways_xhprof_enable'
|
|
],
|
|
$args
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Stop xhprof profiler
|
|
*
|
|
* @return array|null xhprof data from the run, or null if xhprof was not running.
|
|
*/
|
|
public static function disable() {
|
|
if ( self::isEnabled() ) {
|
|
self::$enabled = false;
|
|
return self::callAny( [
|
|
'xhprof_disable',
|
|
'tideways_disable',
|
|
'tideways_xhprof_disable'
|
|
] );
|
|
} else {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Call the first available function from $functions.
|
|
* @param array $functions
|
|
* @param array $args
|
|
* @return mixed
|
|
* @throws Exception
|
|
*/
|
|
protected static function callAny( array $functions, array $args = [] ) {
|
|
foreach ( $functions as $func ) {
|
|
if ( function_exists( $func ) ) {
|
|
return $func( ...$args );
|
|
}
|
|
}
|
|
|
|
throw new Exception( "Neither xhprof nor tideways are installed" );
|
|
}
|
|
}
|