refactoring cache and session classes.

laravel/cache/drivers/apc.php

@@ -7,7 +7,7 @@ class APC extends Driver {
 	 *
 	 * @var string
 	 */
-	private $key;
+	protected $key;
 
 	/**
 	 * Create a new APC cache driver instance.
@@ -45,6 +45,11 @@ class APC extends Driver {
 	/**
 	 * Write an item to the cache for a given number of minutes.
 	 *
+	 * <code>
+	 *		// Put an item in the cache for 15 minutes
+	 *		Cache::put('name', 'Taylor', 15);
+	 * </code>
+	 *
 	 * @param  string  $key
 	 * @param  mixed   $value
 	 * @param  int     $minutes

laravel/cache/drivers/file.php

@@ -1,4 +1,4 @@
-<?php namespace Laravel\Cache\Drivers; use Laravel\File as F;
+<?php namespace Laravel\Cache\Drivers;
 
 class File extends Driver {
 
@@ -7,7 +7,7 @@ class File extends Driver {
 	 *
 	 * @var string
 	 */
-	private $path;
+	protected $path;
 
 	/**
 	 * Create a new File cache driver instance.
@@ -39,9 +39,9 @@ class File extends Driver {
 	 */
 	protected function retrieve($key)
 	{
-		if ( ! F::exists($this->path.$key)) return null;
+		if ( ! \Laravel\File::exists($this->path.$key)) return null;
 
-		if (time() >= substr($cache = F::get($this->path.$key), 0, 10))
+		if (time() >= substr($cache = \Laravel\File::get($this->path.$key), 0, 10))
 		{
 			return $this->forget($key);
 		}
@@ -52,6 +52,11 @@ class File extends Driver {
 	/**
 	 * Write an item to the cache for a given number of minutes.
 	 *
+	 * <code>
+	 *		// Put an item in the cache for 15 minutes
+	 *		Cache::put('name', 'Taylor', 15);
+	 * </code>
+	 *
 	 * @param  string  $key
 	 * @param  mixed   $value
 	 * @param  int     $minutes
@@ -59,7 +64,7 @@ class File extends Driver {
 	 */
 	public function put($key, $value, $minutes)
 	{
-		F::put($this->path.$key, (time() + ($minutes * 60)).serialize($value));
+		\Laravel\File::put($this->path.$key, (time() + ($minutes * 60)).serialize($value));
 	}
 
 	/**
@@ -70,7 +75,7 @@ class File extends Driver {
 	 */
 	public function forget($key)
 	{
-		F::delete($this->path.$key);
+		\Laravel\File::delete($this->path.$key);
 	}
 
 }

laravel/cache/drivers/memcached.php

@@ -7,14 +7,14 @@ class Memcached extends Driver {
 	 *
 	 * @var Memcache
 	 */
-	private $memcache;
+	protected $memcache;
 
 	/**
 	 * The cache key from the cache configuration file.
 	 *
 	 * @var string
 	 */
-	private $key;
+	protected $key;
 
 	/**
 	 * Create a new Memcached cache driver instance.
@@ -53,6 +53,11 @@ class Memcached extends Driver {
 	/**
 	 * Write an item to the cache for a given number of minutes.
 	 *
+	 * <code>
+	 *		// Put an item in the cache for 15 minutes
+	 *		Cache::put('name', 'Taylor', 15);
+	 * </code>
+	 *
 	 * @param  string  $key
 	 * @param  mixed   $value
 	 * @param  int     $minutes

laravel/cache/manager.php

@@ -1,6 +1,4 @@
-<?php namespace Laravel\Cache;
-
-use Laravel\IoC;
+<?php namespace Laravel\Cache; use Laravel\IoC;
 
 class Manager {
 

laravel/proxy.php

@@ -0,0 +1,21 @@
+<?php namespace Laravel;
+
+/**
+ * The Proxy class, like the File class, is primarily intended to get rid of
+ * the testability problems introduced by PHP's global functions.
+ *
+ * For instance, the APC cache driver calls the APC global functions. Instead of
+ * calling those functions directory in the driver, we inject a Proxy instance into
+ * the class, which allows us to stub the global functions.
+ */
+class Proxy {
+
+	/**
+	 * Magic Method for calling any global function.
+	 */
+	public function __call($method, $parameters)
+	{
+		return call_user_func_array($method, $parameters);
+	}
+
+}

laravel/session/manager.php

@@ -58,9 +58,10 @@ class Manager {
 	{
 		$session = $this->driver->load($this->transporter->get($config));
 
-		// If the session is expired, a new session will be generated and all of the data from
-		// the previous session will be lost. The new session will be assigned a random, long
-		// string ID to uniquely identify it among the application's current users.
+		// If the session is expired, a new session will be generated and all of
+		// the data from the previous session will be lost. The new session will
+		// be assigned a random, long string ID to uniquely identify it among
+		// the application's current users.
 		if (is_null($session) or (time() - $session['last_activity']) > ($config['lifetime'] * 60))
 		{
 			$this->exists = false;
@@ -70,10 +71,11 @@ class Manager {
 
 		$payload = new Payload($session);
 
-		// If a CSRF token is not present in the session, we will generate one. These tokens
-		// are generated per session to protect against Cross-Site Request Forgery attacks on
-		// the application. It is up to the developer to take advantage of them using the token
-		// methods on the Form class and the "csrf" route filter.
+		// If a CSRF token is not present in the session, we will generate one.
+		// These tokens are generated per session to protect against Cross-Site
+		// Request Forgery attacks on the application. It is up to the developer
+		// to take advantage of them using the token methods on the Form class
+		// and the "csrf" route filter.
 		if ( ! $payload->has('csrf_token'))
 		{
 			$payload->put('csrf_token', Str::random(16));
@@ -92,8 +94,9 @@ class Manager {
 	 */
 	public function close(Payload $payload, $config, $flash = array())
 	{
-		// If the session ID has been regenerated, we will need to inform the session driver
-		// that the session will need to be persisted to the data store as a new session.
+		// If the session ID has been regenerated, we will need to inform the
+		// session driver that the session will need to be persisted to the
+		// data store as a new session.
 		if ($payload->regenerated) $this->exists = false;
 
 		foreach ($flash as $key => $value)
@@ -105,9 +108,10 @@ class Manager {
 
 		$this->transporter->put($payload->session['id'], $config);
 
-		// Some session drivers implement the Sweeper interface, which specified that the driver
-		// must do its garbage collection manually. Alternatively, some drivers such as APC and
-		// Memcached are not required to manually clean up their sessions.
+		// Some session drivers may implement the Sweeper interface, meaning the
+		// driver must do its garbage collection manually. Alternatively, some
+		// drivers such as APC and Memcached are not required to manually
+		// clean up their sessions.
 		if (mt_rand(1, $config['sweepage'][1]) <= $config['sweepage'][0] and $this->driver instanceof Drivers\Sweeper)
 		{
 			$this->driver->sweep(time() - ($config['lifetime'] * 60));

laravel/session/payload.php

@@ -1,7 +1,4 @@
-<?php namespace Laravel\Session;
-
-use Closure;
-use Laravel\Str;
+<?php namespace Laravel\Session; use Closure, Laravel\Str;
 
 class Payload {
 
@@ -119,7 +116,7 @@ class Payload {
 	 */
 	public function reflash()
 	{
-		$this->readdress(':old:', ':new:', array_keys($this->session['data']));
+		$this->replace(':old:', ':new:', array_keys($this->session['data']));
 	}
 
 	/**
@@ -197,7 +194,7 @@ class Payload {
 			if (strpos($key, ':old:') === 0) $this->forget($key);
 		}
 
-		$this->readdress(':new:', ':old:', array_keys($this->session['data']));
+		$this->replace(':new:', ':old:', array_keys($this->session['data']));
 
 		return $this->session;
 	}
@@ -210,7 +207,7 @@ class Payload {
 	 * @param  array   $keys
 	 * @return void
 	 */
-	private function readdress($search, $replace, $keys)
+	private function replace($search, $replace, $keys)
 	{
 		$this->session['data'] = array_combine(str_replace($search, $replace, $keys), array_values($this->session['data']));
 	}