initial commit

lib/symfony/debug/sfTimer.class.php

@@ -0,0 +1,84 @@
+<?php
+
+/*
+ * This file is part of the symfony package.
+ * (c) 2004-2006 Fabien Potencier <fabien.potencier@symfony-project.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+/**
+ * sfTimer class allows to time some PHP code.
+ *
+ * @package    symfony
+ * @subpackage util
+ * @author     Fabien Potencier <fabien.potencier@symfony-project.com>
+ * @version    SVN: $Id: sfTimer.class.php 3411 2007-02-06 08:17:38Z fabien $
+ */
+class sfTimer
+{
+  protected
+    $startTime = null,
+    $totalTime = null,
+    $name = '',
+    $calls = 0;
+
+  /**
+   * Creates a new sfTimer instance.
+   *
+   * @param string The name of the timer
+   */
+  public function __construct($name = '')
+  {
+    $this->name = $name;
+    $this->startTimer();
+  }
+
+  /**
+   * Starts the timer.
+   */
+  public function startTimer()
+  {
+    $this->startTime = microtime(true);
+  }
+
+  /**
+   * Stops the timer and add the amount of time since the start to the total time.
+   *
+   * @return integer Time spend for the last call
+   */
+  public function addTime()
+  {
+    $spend = microtime(true) - $this->startTime;
+    $this->totalTime += $spend;
+    ++$this->calls;
+
+    return $spend;
+  }
+
+  /**
+   * Gets the number of calls this timer has been called to time code.
+   *
+   * @return integer Number of calls
+   */
+  public function getCalls()
+  {
+    return $this->calls;
+  }
+
+  /**
+   * Gets the total time elapsed for all calls of this timer.
+   *
+   * @return integer Time in milliseconds
+   */
+  public function getElapsedTime()
+  {
+    if (null === $this->totalTime)
+    {
+      $this->addTime();
+    }
+
+    return $this->totalTime;
+  }
+}