Adds configurable mutability options

Author: sagikazarmark

src/Configurable.php

@@ -14,12 +14,15 @@
 /**
  * Allows global configurations
  *
+ * This interface does not allow modifying options
+ * Check the specific mutable and immutable interfaces
+ *
  * @author Márk Sági-Kazár [email protected]>
  */
 interface Configurable
 {
     /**
-     * Returns a sepcific option or null
+     * Returns an option by name
      *
      * @param string $name
      *
@@ -35,7 +38,7 @@ public function getOption($name);
     public function getOptions();
 
     /**
-     * Checks if an option is set
+     * Checks if an option exists
      *
      * @param string $name
      *
@@ -44,17 +47,9 @@ public function getOptions();
     public function hasOption($name);
 
     /**
-     * Sets an option
+     * Checks if any option exists
      *
-     * @param string $name
-     * @param mixed  $option
-     */
-    public function setOption($name, $option);
-
-    /**
-     * Sets all options
-     *
-     * @param array $options
+     * @return boolean
      */
-    public function setOptions($options);
+    public function hasOptions();
 }

src/Configurable/ImmutableConfigurable.php

@@ -0,0 +1,41 @@
+<?php
+
+/*
+ * This file is part of the Http Adapter package.
+ *
+ * (c) Eric GELOEN <[email protected]>
+ *
+ * For the full copyright and license information, please read the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Http\Adapter\Configurable;
+
+use Http\Adapter\Configurable;
+
+/**
+ * Allows to modify configuration an immutable way
+ *
+ * @author Márk Sági-Kazár [email protected]>
+ */
+interface ImmutableConfigurable extends Configurable
+{
+    /**
+     * Sets an option
+     *
+     * @param string $name
+     * @param mixed  $option
+     *
+     * @return self
+     */
+    public function withOption($name, $option);
+
+    /**
+     * Removes an option
+     *
+     * @param string $name
+     *
+     * @return self
+     */
+    public function withoutOption($name);
+}

src/Configurable/MutableConfigurable.php

@@ -0,0 +1,37 @@
+<?php
+
+/*
+ * This file is part of the Http Adapter package.
+ *
+ * (c) Eric GELOEN <[email protected]>
+ *
+ * For the full copyright and license information, please read the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Http\Adapter\Configurable;
+
+use Http\Adapter\Configurable;
+
+/**
+ * Allows to modify configuration a mutable way
+ *
+ * @author Márk Sági-Kazár [email protected]>
+ */
+interface MutableConfigurable extends Configurable
+{
+    /**
+     * Sets an option
+     *
+     * @param string $name
+     * @param mixed  $option
+     */
+    public function setOption($name, $option);
+
+    /**
+     * Sets all options
+     *
+     * @param array $options
+     */
+    public function setOptions($options);
+}

src/Message/InternalRequest.php

@@ -11,12 +11,13 @@
 
 namespace Http\Adapter\Message;
 
+use Http\Adapter\Configurable\ImmutableConfigurable;
 use Psr\Http\Message\RequestInterface;
 
 /**
  * @author GeLo <[email protected]>
  */
-interface InternalRequest extends RequestInterface, ParameterableMessage
+interface InternalRequest extends RequestInterface, ParameterableMessage, ImmutableConfigurable
 {
     /**
      * Returns some data by name
@@ -89,14 +90,14 @@ public function withoutData($name);
     public function getFile($name);
 
     /**
-     * Returns the files
+     * Returns all files
      *
      * @return array
      */
     public function getFiles();
 
     /**
-     * Checks if the file exists
+     * Checks if a file exists
      *
      * @param string $name
      *

src/Message/ParameterableMessage.php

@@ -28,14 +28,14 @@ interface ParameterableMessage
     public function getParameter($name);
 
     /**
-     * Returns the parameters
+     * Returns all parameters
      *
      * @return array
      */
     public function getParameters();
 
     /**
-     * Checks if the parameter exists
+     * Checks if a parameter exists
      *
      * @param string $name
      *