wp_back/wp-content/plugins/query-monitor/classes/Timer.php

184 lines
2.8 KiB
PHP
Raw Normal View History

2024-05-20 15:37:46 +03:00
<?php declare(strict_types = 1);
/**
* Timer that collects timing and memory usage.
*
* @package query-monitor
*/
class QM_Timer {
/**
* @var array<string, mixed>
* @phpstan-var array{
* time: float,
* memory: int,
* data: mixed[]|null,
* }
*/
protected $start;
/**
* @var array<string, mixed>|null
* @phpstan-var array{
* time: float,
* memory: int,
* data: mixed[]|null,
* }|null
*/
protected $end = null;
/**
* @var QM_Backtrace
*/
protected $trace;
/**
* @var array<string, array<string, mixed>>
* @phpstan-var array<string, array{
* time: float,
* memory: int,
* data: mixed[]|null,
* }>
*/
protected $laps = array();
/**
* @param mixed[] $data
* @return self
*/
public function start( array $data = null ) {
$this->trace = new QM_Backtrace();
$this->start = array(
'time' => microtime( true ),
'memory' => memory_get_usage(),
'data' => $data,
);
return $this;
}
/**
* @param mixed[] $data
* @return self
*/
public function stop( array $data = null ) {
$this->end = array(
'time' => microtime( true ),
'memory' => memory_get_usage(),
'data' => $data,
);
return $this;
}
/**
* @param mixed[] $data
* @param string $name
* @return self
*/
public function lap( array $data = null, $name = null ) {
$lap = array(
'time' => microtime( true ),
'memory' => memory_get_usage(),
'data' => $data,
);
if ( ! isset( $name ) ) {
$i = sprintf(
/* translators: %s: Timing lap number */
__( 'Lap %s', 'query-monitor' ),
number_format_i18n( count( $this->laps ) + 1 )
);
} else {
$i = $name;
}
$this->laps[ $i ] = $lap;
return $this;
}
/**
* @return mixed[]
*/
public function get_laps() {
$laps = array();
$prev = $this->start;
foreach ( $this->laps as $lap_id => $lap ) {
$lap['time_used'] = $lap['time'] - $prev['time'];
$lap['memory_used'] = $lap['memory'] - $prev['memory'];
$laps[ $lap_id ] = $lap;
$prev = $lap;
}
return $laps;
}
/**
* @return float
*/
public function get_time() {
return $this->end['time'] - $this->start['time'];
}
/**
* @return int
*/
public function get_memory() {
return $this->end['memory'] - $this->start['memory'];
}
/**
* @return float
*/
public function get_start_time() {
return $this->start['time'];
}
/**
* @return int
*/
public function get_start_memory() {
return $this->start['memory'];
}
/**
* @return float
*/
public function get_end_time() {
return $this->end['time'];
}
/**
* @return int
*/
public function get_end_memory() {
return $this->end['memory'];
}
/**
* @return QM_Backtrace
*/
public function get_trace() {
return $this->trace;
}
/**
* @param mixed[] $data
* @return self
*/
public function end( array $data = null ) {
return $this->stop( $data );
}
}