1 files changed, 102 insertions, 36 deletions

diff --git a/engine/classes/ElggFileCache.php b/engine/classes/ElggFileCache.php
index 61a2357b5..94143f777 100644
--- a/engine/classes/ElggFileCache.php
+++ b/engine/classes/ElggFileCache.php
@@ -3,35 +3,56 @@
  * ElggFileCache
  * Store cached data in a file store.
  *
- * @author Curverider Ltd <info@elgg.com>
- * @package Elgg
- * @subpackage API
+ * @package    Elgg.Core
+ * @subpackage Caches
  */
 class ElggFileCache extends ElggCache {
 	/**
 	 * Set the Elgg cache.
 	 *
 	 * @param string $cache_path The cache path.
-	 * @param int $max_age Maximum age in seconds, 0 if no limit.
-	 * @param int $max_size Maximum size of cache in seconds, 0 if no limit.
+	 * @param int    $max_age    Maximum age in seconds, 0 if no limit.
+	 * @param int    $max_size   Maximum size of cache in seconds, 0 if no limit.
+	 *
+	 * @throws ConfigurationException
 	 */
 	function __construct($cache_path, $max_age = 0, $max_size = 0) {
-		$this->set_variable("cache_path", $cache_path);
-		$this->set_variable("max_age", $max_age);
-		$this->set_variable("max_size", $max_size);
+		$this->setVariable("cache_path", $cache_path);
+		$this->setVariable("max_age", $max_age);
+		$this->setVariable("max_size", $max_size);
 
-		if ($cache_path=="") {
+		if ($cache_path == "") {
 			throw new ConfigurationException(elgg_echo('ConfigurationException:NoCachePath'));
 		}
 	}
 
+	// @codingStandardsIgnoreStart
 	/**
 	 * Create and return a handle to a file.
 	 *
-	 * @param string $filename
-	 * @param string $rw
+	 * @deprecated 1.8 Use ElggFileCache::createFile()
+	 *
+	 * @param string $filename Filename to save as
+	 * @param string $rw       Write mode
+	 *
+	 * @return mixed
 	 */
 	protected function create_file($filename, $rw = "rb") {
+		elgg_deprecated_notice('ElggFileCache::create_file() is deprecated by ::createFile()', 1.8);
+
+		return $this->createFile($filename, $rw);
+	}
+	// @codingStandardsIgnoreEnd
+
+	/**
+	 * Create and return a handle to a file.
+	 *
+	 * @param string $filename Filename to save as
+	 * @param string $rw       Write mode
+	 *
+	 * @return mixed
+	 */
+	protected function createFile($filename, $rw = "rb") {
 		// Create a filename matrix
 		$matrix = "";
 		$depth = strlen($filename);
@@ -40,39 +61,59 @@ class ElggFileCache extends ElggCache {
 		}
 
 		// Create full path
-		$path = $this->get_variable("cache_path") . $matrix;
+		$path = $this->getVariable("cache_path") . $matrix;
 		if (!is_dir($path)) {
 			mkdir($path, 0700, true);
 		}
 
 		// Open the file
-		if ((!file_exists($path . $filename)) && ($rw=="rb")) {
+		if ((!file_exists($path . $filename)) && ($rw == "rb")) {
 			return false;
 		}
 
 		return fopen($path . $filename, $rw);
 	}
 
+	// @codingStandardsIgnoreStart
 	/**
 	 * Create a sanitised filename for the file.
 	 *
-	 * @param string $filename
+	 * @deprecated 1.8 Use ElggFileCache::sanitizeFilename()
+	 *
+	 * @param string $filename The filename
+	 *
+	 * @return string
 	 */
 	protected function sanitise_filename($filename) {
 		// @todo : Writeme
 
 		return $filename;
 	}
+	// @codingStandardsIgnoreEnd
+
+	/**
+	 * Create a sanitised filename for the file.
+	 *
+	 * @param string $filename The filename
+	 *
+	 * @return string
+	 */
+	protected function sanitizeFilename($filename) {
+		// @todo : Writeme
+
+		return $filename;
+	}
 
 	/**
 	 * Save a key
 	 *
-	 * @param string $key
-	 * @param string $data
+	 * @param string $key  Name
+	 * @param string $data Value
+	 *
 	 * @return boolean
 	 */
 	public function save($key, $data) {
-		$f = $this->create_file($this->sanitise_filename($key), "wb");
+		$f = $this->createFile($this->sanitizeFilename($key), "wb");
 		if ($f) {
 			$result = fwrite($f, $data);
 			fclose($f);
@@ -86,18 +127,19 @@ class ElggFileCache extends ElggCache {
 	/**
 	 * Load a key
 	 *
-	 * @param string $key
-	 * @param int $offset
-	 * @param int $limit
+	 * @param string $key    Name
+	 * @param int    $offset Offset
+	 * @param int    $limit  Limit
+	 *
 	 * @return string
 	 */
 	public function load($key, $offset = 0, $limit = null) {
-		$f = $this->create_file($this->sanitise_filename($key));
+		$f = $this->createFile($this->sanitizeFilename($key));
 		if ($f) {
-			//fseek($f, $offset);
 			if (!$limit) {
 				$limit = -1;
 			}
+
 			$data = stream_get_contents($f, $limit, $offset);
 
 			fclose($f);
@@ -111,54 +153,78 @@ class ElggFileCache extends ElggCache {
 	/**
 	 * Invalidate a given key.
 	 *
-	 * @param string $key
+	 * @param string $key Name
+	 *
 	 * @return bool
 	 */
 	public function delete($key) {
-		$dir = $this->get_variable("cache_path");
-		
-		if (file_exists($dir.$key)) {
-			return unlink($dir.$key);
+		$dir = $this->getVariable("cache_path");
+
+		if (file_exists($dir . $key)) {
+			return unlink($dir . $key);
 		}
 		return TRUE;
 	}
 
+	/**
+	 * Delete all files in the directory of this file cache
+	 *
+	 * @return void
+	 */
 	public function clear() {
-		// @todo writeme
+		$dir = $this->getVariable("cache_path");
+
+		$exclude = array(".", "..");
+
+		$files = scandir($dir);
+		if (!$files) {
+			return;
+		}
+
+		foreach ($files as $f) {
+			if (!in_array($f, $exclude)) {
+				unlink($dir . $f);
+			}
+		}
 	}
 
+	/**
+	 * Preform cleanup and invalidates cache upon object destruction
+	 *
+	 * @throws IOException
+	 */
 	public function __destruct() {
 		// @todo Check size and age, clean up accordingly
 		$size = 0;
-		$dir = $this->get_variable("cache_path");
+		$dir = $this->getVariable("cache_path");
 
 		// Short circuit if both size and age are unlimited
-		if (($this->get_variable("max_age")==0) && ($this->get_variable("max_size")==0)) {
+		if (($this->getVariable("max_age") == 0) && ($this->getVariable("max_size") == 0)) {
 			return;
 		}
 
-		$exclude = array(".","..");
+		$exclude = array(".", "..");
 
 		$files = scandir($dir);
 		if (!$files) {
-			throw new IOException(sprintf(elgg_echo('IOException:NotDirectory'), $dir));
+			throw new IOException(elgg_echo('IOException:NotDirectory', array($dir)));
 		}
 
 		// Perform cleanup
 		foreach ($files as $f) {
 			if (!in_array($f, $exclude)) {
-				$stat = stat($dir.$f);
+				$stat = stat($dir . $f);
 
 				// Add size
 				$size .= $stat['size'];
 
 				// Is this older than my maximum date?
-				if (($this->get_variable("max_age")>0) && (time() - $stat['mtime'] > $this->get_variable("max_age"))) {
-					unlink($dir.$f);
+				if (($this->getVariable("max_age") > 0) && (time() - $stat['mtime'] > $this->getVariable("max_age"))) {
+					unlink($dir . $f);
 				}
 
 				// @todo Size
 			}
 		}
 	}
-}
\ No newline at end of file
+}