Arbitrary section name based PHP profiling. More...

Collaboration diagram for SectionProfiler:

Public Member Functions
	__construct (array $params=[])

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

	profileInInternal ( $functionname)
	This method should not be called outside SectionProfiler.

	profileOutInternal ( $functionname)
	This method should not be called outside SectionProfiler.

	reset ()
	Clear all of the profiling data for another run.

	scopedProfileIn ( $section)

	scopedProfileOut (?SectionProfileCallback &$section)

Protected Member Functions
	collateData ()
	Populate collated data.

	getErrorEntry ()

	getTime ( $metric='wall')
	Get the initial time of the request, based on getrusage()

	getZeroEntry ()

	updateEntry ( $name, $elapsedCpu, $elapsedReal, $memChange)
	Update the collation entry for a given method name.

Protected Attributes
array[]	$collated = []
	Map of (function name => aggregate data array)

bool	$collateDone = false

array null	$end
	Map of (mem,real,cpu)

array	$errorEntry
	Cache of a standard broken collation entry.

LoggerInterface	$logger

array[]	$stack = []
	List of resolved profile calls with start/end data.

array null	$start
	Map of (mem,real,cpu)

array	$workStack = []
	Queue of open profile calls with start data.

Detailed Description

Arbitrary section name based PHP profiling.

This custom profiler can track code execution that doesn't cleanly map to a function call and thus can't be handled by ProfilerXhprof or ProfilerExcimer. For example, parser invocations or DB queries.

Since: 1.25

Definition at line 20 of file SectionProfiler.php.

Constructor & Destructor Documentation

◆ __construct()

SectionProfiler::__construct ( array $params = [] )

Parameters

array $params

Definition at line 42 of file SectionProfiler.php.

References getErrorEntry().

Member Function Documentation

◆ collateData()

SectionProfiler::collateData ( )

protected

Populate collated data.

Definition at line 254 of file SectionProfiler.php.

◆ getErrorEntry()

SectionProfiler::getErrorEntry ( )

protected

Returns: array Initial collation entry for errors

Definition at line 155 of file SectionProfiler.php.

Referenced by __construct().

◆ getFunctionStats()

SectionProfiler::getFunctionStats ( )

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.

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 : real time elapsed (ms)
cpu : percent real 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)

Definition at line 81 of file SectionProfiler.php.

◆ getTime()

SectionProfiler::getTime ( $metric = 'wall' )

protected

Get the initial time of the request, based on getrusage()

Parameters

string | bool

$metric

Metric to use, with the following possibilities:

user: User CPU time (without system calls)
cpu: Total CPU time (user and system calls)
wall (or any other string): elapsed time
false (default): will fall back to default metric

Returns: float

Definition at line 275 of file SectionProfiler.php.

◆ getZeroEntry()

SectionProfiler::getZeroEntry ( )

protected

Returns: array Initial collation entry

Definition at line 141 of file SectionProfiler.php.

◆ profileInInternal()

SectionProfiler::profileInInternal ( $functionname )

This method should not be called outside SectionProfiler.

Parameters

string $functionname

Definition at line 188 of file SectionProfiler.php.

Referenced by scopedProfileIn().

◆ profileOutInternal()

SectionProfiler::profileOutInternal ( $functionname )

This method should not be called outside SectionProfiler.

Parameters

string $functionname

Definition at line 216 of file SectionProfiler.php.

◆ reset()

SectionProfiler::reset ( )

Clear all of the profiling data for another run.

Definition at line 129 of file SectionProfiler.php.

◆ scopedProfileIn()

SectionProfiler::scopedProfileIn ( $section )

Parameters

string $section

Definition at line 50 of file SectionProfiler.php.

References profileInInternal().

◆ scopedProfileOut()

SectionProfiler::scopedProfileOut ( ?SectionProfileCallback & $section )

Definition at line 56 of file SectionProfiler.php.

◆ updateEntry()

SectionProfiler::updateEntry	(	$name,
		$elapsedCpu,
		$elapsedReal,
		$memChange )

protected

Update the collation entry for a given method name.

Parameters

string	$name
float	$elapsedCpu
float	$elapsedReal
int	$memChange

Definition at line 169 of file SectionProfiler.php.

Member Data Documentation

◆ $collated

array [] SectionProfiler::$collated = []

protected

Map of (function name => aggregate data array)

Definition at line 30 of file SectionProfiler.php.

◆ $collateDone

bool SectionProfiler::$collateDone = false

protected

Definition at line 32 of file SectionProfiler.php.

◆ $end

array null SectionProfiler::$end

protected

Map of (mem,real,cpu)

Definition at line 24 of file SectionProfiler.php.

◆ $errorEntry

array SectionProfiler::$errorEntry

protected

Cache of a standard broken collation entry.

Definition at line 35 of file SectionProfiler.php.

◆ $logger

LoggerInterface SectionProfiler::$logger

protected

Definition at line 37 of file SectionProfiler.php.

◆ $stack

array [] SectionProfiler::$stack = []

protected

List of resolved profile calls with start/end data.

Definition at line 26 of file SectionProfiler.php.

◆ $start

array null SectionProfiler::$start

protected

Map of (mem,real,cpu)

Definition at line 22 of file SectionProfiler.php.

◆ $workStack

array SectionProfiler::$workStack = []

protected

Queue of open profile calls with start data.

Definition at line 28 of file SectionProfiler.php.

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

includes/Profiler/SectionProfiler.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ collateData()

◆ getErrorEntry()

◆ getFunctionStats()

◆ getTime()

◆ getZeroEntry()

◆ profileInInternal()

◆ profileOutInternal()

◆ reset()

◆ scopedProfileIn()

◆ scopedProfileOut()

◆ updateEntry()

Member Data Documentation

◆ $collated

◆ $collateDone

◆ $end

◆ $errorEntry

◆ $logger

◆ $stack

◆ $start

◆ $workStack