Class Kohana_Profiler

Kohana_Profiler

Provides simple benchmarking and profiling. To display the statistics that have been collected, load the profiler/stats View:

echo View::factory('profiler/stats');

package
Kohana
category
Helpers
author
Kohana Team
copyright
(c) Kohana Team
license
https://koseven.ga/LICENSE.md


Properties

public static integer $rollover

maximum number of application stats to keep

integer 1000

protected static array $_marks

collected benchmarks

array(0) 

Methods

public static application() (defined in Kohana_Profiler)

Gets the total application run time and memory usage. Caches the result so that it can be compared between requests.

list($time, $memory) = Profiler::application();

Tags

Return Values

  • array - Execution time, memory

Source Code

public static function application()
{
	// Load the stats from cache, which is valid for 1 day
	$stats = Kohana::cache('profiler_application_stats', NULL, 3600 * 24);

	if ( ! is_array($stats) OR $stats['count'] > Profiler::$rollover)
	{
		// Initialize the stats array
		$stats = [
			'min'   => [
				'time'   => NULL,
				'memory' => NULL],
			'max'   => [
				'time'   => NULL,
				'memory' => NULL],
			'total' => [
				'time'   => NULL,
				'memory' => NULL],
			'count' => 0];
	}

	// Get the application run time
	$time = microtime(TRUE) - KOHANA_START_TIME;

	// Get the total memory usage
	$memory = memory_get_usage() - KOHANA_START_MEMORY;

	// Calculate max time
	if ($stats['max']['time'] === NULL OR $time > $stats['max']['time'])
	{
		$stats['max']['time'] = $time;
	}

	// Calculate min time
	if ($stats['min']['time'] === NULL OR $time < $stats['min']['time'])
	{
		$stats['min']['time'] = $time;
	}

	// Add to total time
	$stats['total']['time'] += $time;

	// Calculate max memory
	if ($stats['max']['memory'] === NULL OR $memory > $stats['max']['memory'])
	{
		$stats['max']['memory'] = $memory;
	}

	// Calculate min memory
	if ($stats['min']['memory'] === NULL OR $memory < $stats['min']['memory'])
	{
		$stats['min']['memory'] = $memory;
	}

	// Add to total memory
	$stats['total']['memory'] += $memory;

	// Another mark has been added to the stats
	$stats['count']++;

	// Determine the averages
	$stats['average'] = [
		'time'   => $stats['total']['time'] / $stats['count'],
		'memory' => $stats['total']['memory'] / $stats['count']];

	// Cache the new stats
	Kohana::cache('profiler_application_stats', $stats);

	// Set the current application execution time and memory
	// Do NOT cache these, they are specific to the current request only
	$stats['current']['time']   = $time;
	$stats['current']['memory'] = $memory;

	// Return the total application run time and memory usage
	return $stats;
}

public static delete(string $token ) (defined in Kohana_Profiler)

Deletes a benchmark. If an error occurs during the benchmark, it is recommended to delete the benchmark to prevent statistics from being adversely affected.

Profiler::delete($token);

Parameters

  • string $token required - $token

Return Values

  • void

Source Code

public static function delete($token)
{
	// Remove the benchmark
	unset(Profiler::$_marks[$token]);
}

public static group_stats([ mixed $groups = NULL ] ) (defined in Kohana_Profiler)

Gets the min, max, average and total of profiler groups as an array.

$stats = Profiler::group_stats('test');

Parameters

  • mixed $groups = NULL - Single group name string, or array with group names; all groups by default

Tags

Return Values

  • array - Min, max, average, total

Source Code

public static function group_stats($groups = NULL)
{
	// Which groups do we need to calculate stats for?
	$groups = ($groups === NULL)
		? Profiler::groups()
		: array_intersect_key(Profiler::groups(), array_flip( (array) $groups));

	// All statistics
	$stats = [];

	foreach ($groups as $group => $names)
	{
		foreach ($names as $name => $tokens)
		{
			// Store the stats for each subgroup.
			// We only need the values for "total".
			$_stats = Profiler::stats($tokens);
			$stats[$group][$name] = $_stats['total'];
		}
	}

	// Group stats
	$groups = [];

	foreach ($stats as $group => $names)
	{
		// Min and max are unknown by default
		$groups[$group]['min'] = $groups[$group]['max'] = [
			'time' => NULL,
			'memory' => NULL];

		// Total values are always integers
		$groups[$group]['total'] = [
			'time' => 0,
			'memory' => 0];

		foreach ($names as $total)
		{
			if ( ! isset($groups[$group]['min']['time']) OR $groups[$group]['min']['time'] > $total['time'])
			{
				// Set the minimum time
				$groups[$group]['min']['time'] = $total['time'];
			}
			if ( ! isset($groups[$group]['min']['memory']) OR $groups[$group]['min']['memory'] > $total['memory'])
			{
				// Set the minimum memory
				$groups[$group]['min']['memory'] = $total['memory'];
			}

			if ( ! isset($groups[$group]['max']['time']) OR $groups[$group]['max']['time'] < $total['time'])
			{
				// Set the maximum time
				$groups[$group]['max']['time'] = $total['time'];
			}
			if ( ! isset($groups[$group]['max']['memory']) OR $groups[$group]['max']['memory'] < $total['memory'])
			{
				// Set the maximum memory
				$groups[$group]['max']['memory'] = $total['memory'];
			}

			// Increase the total time and memory
			$groups[$group]['total']['time']   += $total['time'];
			$groups[$group]['total']['memory'] += $total['memory'];
		}

		// Determine the number of names (subgroups)
		$count = count($names);

		// Determine the averages
		$groups[$group]['average']['time']   = $groups[$group]['total']['time'] / $count;
		$groups[$group]['average']['memory'] = $groups[$group]['total']['memory'] / $count;
	}

	return $groups;
}

public static groups() (defined in Kohana_Profiler)

Returns all the benchmark tokens by group and name as an array.

$groups = Profiler::groups();

Return Values

  • array

Source Code

public static function groups()
{
	$groups = [];

	foreach (Profiler::$_marks as $token => $mark)
	{
		// Sort the tokens by the group and name
		$groups[$mark['group']][$mark['name']][] = $token;
	}

	return $groups;
}

public static start(string $group , string $name ) (defined in Kohana_Profiler)

Starts a new benchmark and returns a unique token. The returned token must be used when stopping the benchmark.

$token = Profiler::start('test', 'profiler');

Parameters

  • string $group required - Group name
  • string $name required - Benchmark name

Return Values

  • string

Source Code

public static function start($group, $name)
{
	static $counter = 0;

	// Create a unique token based on the counter
	$token = 'kp/'.base_convert($counter++, 10, 32);

	Profiler::$_marks[$token] = [
		'group' => strtolower($group),
		'name'  => (string) $name,

		// Start the benchmark
		'start_time'   => microtime(TRUE),
		'start_memory' => memory_get_usage(),

		// Set the stop keys without values
		'stop_time'    => FALSE,
		'stop_memory'  => FALSE,
	];

	return $token;
}

public static stats(array $tokens ) (defined in Kohana_Profiler)

Gets the min, max, average and total of a set of tokens as an array.

$stats = Profiler::stats($tokens);

Parameters

  • array $tokens required - Profiler tokens

Tags

Return Values

  • array - Min, max, average, total

Source Code

public static function stats(array $tokens)
{
	// Min and max are unknown by default
	$min = $max = [
		'time' => NULL,
		'memory' => NULL];

	// Total values are always integers
	$total = [
		'time' => 0,
		'memory' => 0];

	foreach ($tokens as $token)
	{
		// Get the total time and memory for this benchmark
		list($time, $memory) = Profiler::total($token);

		if ($max['time'] === NULL OR $time > $max['time'])
		{
			// Set the maximum time
			$max['time'] = $time;
		}

		if ($min['time'] === NULL OR $time < $min['time'])
		{
			// Set the minimum time
			$min['time'] = $time;
		}

		// Increase the total time
		$total['time'] += $time;

		if ($max['memory'] === NULL OR $memory > $max['memory'])
		{
			// Set the maximum memory
			$max['memory'] = $memory;
		}

		if ($min['memory'] === NULL OR $memory < $min['memory'])
		{
			// Set the minimum memory
			$min['memory'] = $memory;
		}

		// Increase the total memory
		$total['memory'] += $memory;
	}

	// Determine the number of tokens
	$count = count($tokens);

	// Determine the averages
	$average = [
		'time' => $total['time'] / $count,
		'memory' => $total['memory'] / $count];

	return [
		'min' => $min,
		'max' => $max,
		'total' => $total,
		'average' => $average];
}

public static stop(string $token ) (defined in Kohana_Profiler)

Stops a benchmark.

Profiler::stop($token);

Parameters

  • string $token required - $token

Return Values

  • void

Source Code

public static function stop($token)
{
	// Stop the benchmark
	Profiler::$_marks[$token]['stop_time']   = microtime(TRUE);
	Profiler::$_marks[$token]['stop_memory'] = memory_get_usage();
}

public static total(string $token ) (defined in Kohana_Profiler)

Gets the total execution time and memory usage of a benchmark as a list.

list($time, $memory) = Profiler::total($token);

Parameters

  • string $token required - $token

Return Values

  • array - Execution time, memory

Source Code

public static function total($token)
{
	// Import the benchmark data
	$mark = Profiler::$_marks[$token];

	if ($mark['stop_time'] === FALSE)
	{
		// The benchmark has not been stopped yet
		$mark['stop_time']   = microtime(TRUE);
		$mark['stop_memory'] = memory_get_usage();
	}

	return [
		// Total time in seconds
		$mark['stop_time'] - $mark['start_time'],

		// Amount of memory in bytes
		$mark['stop_memory'] - $mark['start_memory'],
	];
}

Do you want to contribute to Koseven?

We need YOUR help!

This project is open source. What does this mean? YOU can help:
  • Found a bug? Report it on Github
  • Need a feature? Add it Here
  • Want to help? Join the Forum
Go to Github