[2.0] Introduce adapter interface and implementations

src/HeaderBag.php

@@ -0,0 +1,111 @@
+<?php
+
+namespace Aidantwoods\SecureHeaders;
+
+use Aidantwoods\SecureHeaders\Util\Types;
+
+class HeaderBag
+{
+    protected $headers = array();
+
+    public function __construct(array $headers = array())
+    {
+        // Send all headers through `add` to make sure they are properly lower-cased
+        foreach ($headers as $name => $value)
+        {
+            $this->add($name, $value);
+        }
+    }
+
+    public static function fromHeaderLines(array $lines)
+    {
+        $bag = new static;
+
+        foreach ($lines as $line)
+        {
+            preg_match('/^([^:]++)(?|(?:[:][ ]?+)(.*+)|())/', $line, $matches);
+            array_shift($matches);
+
+            list($name, $value) = $matches;
+
+            $bag->add($name, $value);
+        }
+
+        return $bag;
+    }
+
+    public function has($name)
+    {
+        Types::assert(array('string' => array($name)));
+
+        return array_key_exists(strtolower($name), $this->headers);
+    }
+
+    public function add($name, $value = '')
+    {
+        Types::assert(array('string' => array($name, $value)));
+
+        $key = strtolower($name);
+        if ( ! array_key_exists($key, $this->headers)) $this->headers[$key] = array();
+
+        $this->headers[$key][] = new Header($name, $value);
+    }
+
+    public function replace($name, $value = '')
+    {
+        Types::assert(array('string' => array($name, $value)));
+
+        $header = new Header($name, $value);
+        $this->headers[strtolower($name)] = array($header);
+    }
+
+    public function remove($name)
+    {
+        Types::assert(array('string' => array($name)));
+
+        unset($this->headers[strtolower($name)]);
+    }
+
+    public function removeAll()
+    {
+        $this->headers = array();
+    }
+
+    public function get()
+    {
+        return array_reduce(
+            $this->headers,
+            function ($all, $item) {
+                return array_merge($all, $item);
+            },
+            array()
+        );
+    }
+}
+
+class Header
+{
+    private $name;
+    private $value;
+
+    public function __construct($name, $value = '')
+    {
+        $this->name = $name;
+        $this->value = $value;
+    }
+
+    public function getName()
+    {
+        return $this->name;
+    }
+
+    public function getValue()
+    {
+        return $this->value;
+    }
+
+    public function __toString()
+    {
+        return $this->name . ':' .(empty($this->value) ? '' : ' ' . $this->value);
+    }
+}

src/Http/GlobalHttpAdapter.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Aidantwoods\SecureHeaders\Http;
+
+use Aidantwoods\SecureHeaders\HeaderBag;
+
+class GlobalHttpAdapter implements HttpAdapter
+{
+    /**
+     * Send the given headers, overwriting all previously send headers
+     *
+     * @param HeaderBag $headers
+     * @return void
+     */
+    public function sendHeaders(HeaderBag $headers)
+    {
+        header_remove();
+
+        foreach ($headers->get() as $header)
+        {
+            header(
+                (string) $header
+            );
+        }
+    }
+
+    /**
+     * Retrieve the current list of already-sent (or planned-to-be-sent) headers
+     *
+     * @return HeaderBag
+     */
+    public function getHeaders()
+    {
+        return HeaderBag::fromHeaderLines(
+            headers_list()
+        );
+    }
+}

src/Http/HttpAdapter.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Aidantwoods\SecureHeaders\Http;
+
+use Aidantwoods\SecureHeaders\HeaderBag;
+
+interface HttpAdapter
+{
+    /**
+     * Send the given headers, overwriting all previously send headers
+     *
+     * @param HeaderBag $headers
+     * @return void
+     */
+    public function sendHeaders(HeaderBag $headers);
+
+    /**
+     * Retrieve the current list of already-sent (or planned-to-be-sent) headers
+     *
+     * @return HeaderBag
+     */
+    public function getHeaders();
+}

src/Http/StringHttpAdapter.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace Aidantwoods\SecureHeaders\Http;
+
+use Aidantwoods\SecureHeaders\HeaderBag;
+
+class StringHttpAdapter implements HttpAdapter
+{
+    private $headers = array();
+
+    /**
+     * Send the given headers, overwriting all previously send headers
+     *
+     * @param HeaderBag $headers
+     * @return void
+     */
+    public function sendHeaders(HeaderBag $headers)
+    {
+        $this->headers = $headers->get();
+    }
+
+    /**
+     * Retrieve the current list of already-sent (or planned-to-be-sent) headers
+     *
+     * @return HeaderBag
+     */
+    public function getHeaders()
+    {
+        return new HeaderBag();
+    }
+
+    public function getHeadersAsString()
+    {
+        $compiledHeaders = array();
+
+        foreach ($this->headers as $header)
+        {
+            $compiledHeaders[] = (string) $header;
+        }
+
+        return implode("\n", $compiledHeaders);
+    }
+}