Add Request::cookie()

lib/Cake/Network/Http/Request.php

@@ -36,9 +36,13 @@ class Request {
 	protected $_version = '1.1';
 
 	protected $_method;
+
 	protected $_content;
+
 	protected $_url;
 
+	protected $_cookies = [];
+
 /**
  * Headers to be sent.
  *
@@ -146,4 +150,36 @@ public function content($content = null) {
 		return $this;
 	}
 
+/**
+ * Get/Set cookie values.
+ *
+ * ### Getting a cookie
+ *
+ * `$request->cookie('session');`
+ *
+ * ### Setting one cookie
+ *
+ * `$request->cookie('session', '123456');`
+ *
+ * ### Setting multiple headers
+ *
+ * `$request->cookie(['test' => 'value', 'split' => 'banana']);`
+ *
+ * @param string $name The name of the cookie to get/set
+ * @param string|null $value Either the value or null when getting values.
+ * @return mixed Either $this or the cookie value.
+ */
+	public function cookie($name, $value = null) {
+		if ($value === null && is_string($name)) {
+			return isset($this->_cookies[$name]) ? $this->_cookies[$name] : null;
+		}
+		if (is_string($name) && is_string($value)) {
+			$name = [$name => $value];
+		}
+		foreach ($name as $key => $val) {
+			$this->_cookies[$key] = $val;
+		}
+		return $this;
+	}
+
 }

lib/Cake/Test/TestCase/Network/Http/RequestTest.php

@@ -97,4 +97,20 @@ public function testHeader() {
 		$this->assertNull($request->header('not set'));
 	}
 
+/**
+ * test cookie method.
+ *
+ * @return void
+ */
+	public function testCookie() {
+		$request = new Request();
+		$result = $request->cookie('session', '123456');
+		$this->assertSame($result, $request, 'Should return self');
+
+		$this->assertNull($request->cookie('not set'));
+
+		$result = $request->cookie('session');
+		$this->assertEquals('123456', $result);
+	}
+
 }