Rename all common/framework source files to be case-sensitive

common/framework/Timer.php

@@ -0,0 +1,109 @@
+<?php
+
+namespace Rhymix\Framework;
+
+/**
+ * The timer class.
+ */
+class Timer
+{
+	/**
+	 * Timestamps are stored here.
+	 */
+	protected static $_timestamps = array();
+	
+	/**
+	 * Start a timer.
+	 * 
+	 * This method returns the current microtime.
+	 * 
+	 * @param string $name (optional)
+	 * @return float
+	 */
+	public static function start($name = null)
+	{
+		$timestamp = microtime(true);
+		
+		if ($name === null)
+		{
+			$name = 'anon-timer-' . $timestamp;
+		}
+		
+		self::$_timestamps[$name] = $timestamp;
+		return $timestamp;
+	}
+	
+	/**
+	 * Stop a timer and return the elapsed time.
+	 * 
+	 * If the name is not given, the most recently started timer will be stopped.
+	 * If no timer has been started, this method returns false.
+	 * 
+	 * @param string $name (optional)
+	 * @return float|false
+	 */
+	public static function stop($name = null)
+	{
+		$timestamp = microtime(true);
+		$started_timestamp = 0;
+		
+		if ($name === null)
+		{
+			if (count(self::$_timestamps))
+			{
+				$started_timestamp = array_pop(self::$_timestamps);
+			}
+			else
+			{
+				return false;
+			}
+		}
+		elseif (array_key_exists($name, self::$_timestamps))
+		{
+			$started_timestamp = self::$_timestamps[$name];
+			unset(self::$_timestamps[$name]);
+		}
+		else
+		{
+			return false;
+		}
+		
+		return $timestamp - $started_timestamp;
+	}
+	
+	/**
+	 * Stop a timer and return the elapsed time in a human-readable format.
+	 * 
+	 * If the name is not given, the most recently started timer will be stopped.
+	 * If no timer has been started, this method returns false.
+	 * 
+	 * @param string $name (optional)
+	 * @return string|false
+	 */
+	public static function stopFormat($name = null)
+	{
+		$result = self::stop($name);
+		if ($result === false) return $result;
+		return number_format($result * 1000, 1, '.', ',') . 'ms';
+	}
+	
+	/**
+	 * This method returns how much time has elapsed since Rhymix startup.
+	 * 
+	 * @return float
+	 */
+	public static function sinceStartup()
+	{
+		return microtime(true) - \RX_MICROTIME;
+	}
+	
+	/**
+	 * This method returns how much time has elapsed since startup in a human-readable format.
+	 *
+	 * @return string
+	 */
+	public static function sinceStartupFormat()
+	{
+		return number_format((microtime(true) - \RX_MICROTIME) * 1000, 1, '.', ',') . 'ms';
+	}
+}