/stir

Record time taken in your PHP website

Primary LanguagePHPMIT LicenseMIT

stir

Record time taken in your PHP website, and display as HTML or JSON.

Enable and disable easily

(When stir is disabled, it falls back to safe-to-use empty functions)

// For example in WordPress, only enable if an administrator user is logged in.
define ('STIR_ENABLED', current_user_can('administrator'));

Measure times

// Start measuring:
function displayPage() // example template function
{
	stir('display page');

	displayHTMLHead();
	stirring('display page', 'html head');

	displayNavigation();
	stirring('display page', 'nav');

	$articles = retrieveLatestArticles();
	$articleIndex = 0;
	foreach ($articles as $article):
		stir('display article');
		displayArticle($article);
		stirred('display article');
		$articleIndex++;
	endforeach;
	stirring('display page', 'articles');

	displayFooter();
	stirring('display page', 'footer');

	displayHTMLEnd();
	stirred('display page');
}

Display recorded times in HTML

// End of page.
stirDisplayRecordedTimesForHTML();
?>
</body>
</html>
<?php

Display recorded times in a JSON response

$action = 'get-user-favorites';
$info = getInfoForUserFavorites();

// The following function still works when stir is set to disabled.
stirDisplayJSONInfo($info, $action);