Profiler base class that defines the interface and some shared functionality. More...

Inheritance diagram for Profiler:

[legend]

Collaboration diagram for Profiler:

[legend]

Public Member Functions
	__construct (array $params)

	close ()
	Close opened profiling sections.

	getAllowOutput ()
	Whether appending profiles is allowed.

	getContentType ()
	Get the Content-Type for deciding how to format appended profile output.

	getContext ()
	Gets the context for this Profiler.

	getFunctionStats ()
	Get the aggregated inclusive profiling data for each method.

	getOutput ()
	Returns a profiling output to be stored in debug file.

	getProfileID ()

	getTransactionProfiler ()

	logData ()
	Log the data to the backing store for all ProfilerOutput instances that have one.

	logDataPageOutputOnly ()
	Log the data to the script/request output for all ProfilerOutput instances that do so.

	profileIn ( $functionname)

	profileOut ( $functionname)

	scopedProfileIn ( $section)
	Mark the start of a custom profiling frame (e.g.

	scopedProfileOut (SectionProfileCallback &$section=null)

	setAllowOutput ()
	Enable appending profiles to standard output.

	setContext ( $context)
	Sets the context for this Profiler.

	setProfileID ( $id)

Static Public Member Functions
static	instance ()
	Singleton.

static	replaceStubInstance (Profiler $profiler)
	Replace the current profiler with $profiler if no non-stub profiler is set.

Protected Attributes
IContextSource	$context = null
	Current request context.

LoggerInterface	$logger

array	$params = []
	All of the params passed from $wgProfiler.

string bool	$profileID = false
	Profiler ID for bucketing data.

TransactionProfiler	$trxProfiler

Private Member Functions
	getOutputs ()
	Get all usable outputs.

Private Attributes
bool	$allowOutput = false

Static Private Attributes
static Profiler	$instance = null

Detailed Description

Profiler base class that defines the interface and some shared functionality.

Definition at line 36 of file Profiler.php.

Constructor & Destructor Documentation

◆ __construct()

Profiler::__construct ( array $params )

Parameters

array $params See $wgProfiler.

Reimplemented in ProfilerExcimer, ProfilerSectionOnly, and ProfilerXhprof.

Definition at line 56 of file Profiler.php.

Member Function Documentation

◆ close()

Profiler::close ( )

abstract

Close opened profiling sections.

Reimplemented in ProfilerExcimer, ProfilerSectionOnly, ProfilerStub, and ProfilerXhprof.

◆ getAllowOutput()

Profiler::getAllowOutput ( )

Whether appending profiles is allowed.

Since: 1.34

Returns: bool

Definition at line 309 of file Profiler.php.

◆ getContentType()

Profiler::getContentType ( )

Get the Content-Type for deciding how to format appended profile output.

Disabled by default. Enable via setAllowOutput().

See also: ProfilerOutputText

Since: 1.25

Returns: string|null Returns null if disabled or no Content-Type found.

Definition at line 283 of file Profiler.php.

References $header.

◆ getContext()

Profiler::getContext ( )

Gets the context for this Profiler.

Returns: IContextSource

Since: 1.25

Definition at line 144 of file Profiler.php.

◆ getFunctionStats()

Profiler::getFunctionStats ( )

abstract

Get the aggregated inclusive profiling data for each method.

The percent time for each time is based on the current "total" time used is based on all methods so far. This method can therefore be called several times in between several profiling calls without the delays in usage of the profiler skewing the results. A "-total" entry is always included in the results.

When a call chain involves a method invoked within itself, any entries for the cyclic invocation should be demarked with "@". This makes filtering them out easier and follows the xhprof style.

Returns

array[] List of method entries arrays, each having:

name : method name
calls : the number of invoking calls
real : real time elapsed (ms)
real : percent real time
cpu : CPU time elapsed (ms)
cpu : percent CPU time
memory : memory used (bytes)
memory : percent memory used
min_real : min real time in a call (ms)
max_real : max real time in a call (ms)

Since: 1.25

Reimplemented in ProfilerExcimer, ProfilerSectionOnly, ProfilerStub, and ProfilerXhprof.

Referenced by logData(), and logDataPageOutputOnly().

◆ getOutput()

Profiler::getOutput ( )

abstract

Returns a profiling output to be stored in debug file.

Returns: string

Reimplemented in ProfilerExcimer, ProfilerSectionOnly, ProfilerStub, and ProfilerXhprof.

◆ getOutputs()

Profiler::getOutputs ( )

private

Get all usable outputs.

Exceptions

MWException

Returns: ProfilerOutput[]

Since: 1.25

Definition at line 199 of file Profiler.php.

Referenced by logData(), and logDataPageOutputOnly().

◆ getProfileID()

Profiler::getProfileID ( )

Returns: string

Definition at line 120 of file Profiler.php.

◆ getTransactionProfiler()

Profiler::getTransactionProfiler ( )

Returns: TransactionProfiler

Since: 1.25

Definition at line 183 of file Profiler.php.

◆ instance()

static Profiler::instance ( )

staticfinal

Singleton.

Returns: Profiler

Definition at line 69 of file Profiler.php.

References $wgProfiler.

Referenced by MediaWiki\Http\HttpRequestFactory\create().

◆ logData()

Profiler::logData ( )

Log the data to the backing store for all ProfilerOutput instances that have one.

Since: 1.25

Reimplemented in ProfilerStub.

Definition at line 224 of file Profiler.php.

References getContext(), getFunctionStats(), and getOutputs().

◆ logDataPageOutputOnly()

Profiler::logDataPageOutputOnly ( )

Log the data to the script/request output for all ProfilerOutput instances that do so.

Exceptions

MWException

Since: 1.26

Reimplemented in ProfilerStub.

Definition at line 254 of file Profiler.php.

References getFunctionStats(), and getOutputs().

◆ profileIn()

Profiler::profileIn ( $functionname )

Definition at line 154 of file Profiler.php.

References wfDeprecated().

◆ profileOut()

Profiler::profileOut ( $functionname )

Definition at line 158 of file Profiler.php.

References wfDeprecated().

◆ replaceStubInstance()

static Profiler::replaceStubInstance ( Profiler $profiler )

staticfinal

Replace the current profiler with $profiler if no non-stub profiler is set.

Parameters

Profiler $profiler

Exceptions

MWException

Since: 1.25

Definition at line 102 of file Profiler.php.

◆ scopedProfileIn()

Profiler::scopedProfileIn ( $section )

abstract

Mark the start of a custom profiling frame (e.g.

DB queries). The frame ends when the result of this method falls out of scope.

Parameters

string $section

Returns: ScopedCallback|null

Since: 1.25

Reimplemented in ProfilerExcimer, ProfilerSectionOnly, ProfilerStub, and ProfilerXhprof.

◆ scopedProfileOut()

Profiler::scopedProfileOut ( SectionProfileCallback & $section = null )

Parameters

SectionProfileCallback | null &$section

Definition at line 175 of file Profiler.php.

◆ setAllowOutput()

Profiler::setAllowOutput ( )

Enable appending profiles to standard output.

Since: 1.34

Definition at line 299 of file Profiler.php.

◆ setContext()

Profiler::setContext ( $context )

Sets the context for this Profiler.

Parameters

IContextSource $context

Since: 1.25

Definition at line 134 of file Profiler.php.

◆ setProfileID()

Profiler::setProfileID ( $id )

Parameters

string $id

Definition at line 113 of file Profiler.php.

Member Data Documentation

◆ $allowOutput

bool Profiler::$allowOutput = false

private

Definition at line 48 of file Profiler.php.

◆ $context

IContextSource Profiler::$context = null

protected

Current request context.

Definition at line 42 of file Profiler.php.

◆ $instance

Profiler Profiler::$instance = null

staticprivate

Definition at line 51 of file Profiler.php.

◆ $logger

LoggerInterface Profiler::$logger

protected

Definition at line 46 of file Profiler.php.

◆ $params

array Profiler::$params = []

protected

All of the params passed from $wgProfiler.

Definition at line 40 of file Profiler.php.

Referenced by ProfilerExcimer\__construct(), ProfilerSectionOnly\__construct(), and ProfilerXhprof\__construct().

◆ $profileID

string bool Profiler::$profileID = false

protected

Profiler ID for bucketing data.

Definition at line 38 of file Profiler.php.

◆ $trxProfiler

TransactionProfiler Profiler::$trxProfiler

protected

Definition at line 44 of file Profiler.php.

The documentation for this class was generated from the following file:

includes/profiler/Profiler.php

Public Member Functions

Static Public Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ close()

◆ getAllowOutput()

◆ getContentType()

◆ getContext()

◆ getFunctionStats()

◆ getOutput()

◆ getOutputs()

◆ getProfileID()

◆ getTransactionProfiler()

◆ instance()

◆ logData()

◆ logDataPageOutputOnly()

◆ profileIn()

◆ profileOut()

◆ replaceStubInstance()

◆ scopedProfileIn()

◆ scopedProfileOut()

◆ setAllowOutput()

◆ setContext()

◆ setProfileID()

Member Data Documentation

◆ $allowOutput

◆ $context

◆ $instance

◆ $logger

◆ $params

◆ $profileID

◆ $trxProfiler