Initial commit

Author: sagikazarmark

.editorconfig

@@ -0,0 +1,13 @@
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+
+[*.yml]
+indent_style = space
+indent_size = 2

.gitattributes

@@ -0,0 +1,4 @@
+.editorconfig    export-ignore
+.gitattributes   export-ignore
+.gitignore       export-ignore
+CONTRIBUTING.md  export-ignore

.gitignore

@@ -0,0 +1,3 @@
+build/
+vendor/
+composer.lock

CHANGELOG.md

@@ -0,0 +1,4 @@
+# Change Log
+
+
+## Unreleased

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2015 PHP HTTP Team <[email protected]>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,78 @@
+# HTTP Message Factory
+
+[![Latest Version](https://img.shields.io/github/release/php-http/message-factory.svg?style=flat-square)](https://github.com/php-http/message-factory/releases)
+[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE)
+[![Total Downloads](https://img.shields.io/packagist/dt/php-http/message-factory.svg?style=flat-square)](https://packagist.org/packages/php-http/message-factory)
+
+**Factory interfaces for PSR-7 HTTP Message.**
+
+
+## Install
+
+Via Composer
+
+``` bash
+$ composer require php-http/message-factory
+```
+
+
+## Usage
+
+This package provides interfaces for PSR-7 factories including:
+
+- `MessageFactory` - WIP
+- `ServerRequestFactory` - WIP
+- `StreamFactory` - WIP
+- `UploadedFileFactory` - WIP
+- `UriFactory` - WIP
+
+
+A virtual package ([php-http/message-factory-implementation](https://packagist.org/providers/php-http/message-factory-implementation)) MAY be introduced which MUST be versioned together with this package.
+
+
+### General usage
+
+``` php
+use Http\Message\SomeFactory;
+
+class MyFactory implements SomeFactory
+{
+
+}
+```
+
+
+### Factory awares and helpers
+
+For each factory there is a helper interface and trait to ease injecting them into other objects (such as HTTP clients).
+
+An example:
+
+``` php
+use Http\Message\SomeFactoryAware;
+use Http\Message\SomeFactoryHelper;
+
+class HttpClient implements SomeFactoryAware
+{
+    use SomeFactoryHelper;
+}
+
+$client = new HttpClient();
+$someFactory = $client->getSomeFactory();
+$client->setSomeFactory($someFactory);
+```
+
+
+## Contributing
+
+Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
+
+
+## Security
+
+If you discover any security related issues, please contact us at [[email protected]](mailto:[email protected]).
+
+
+## License
+
+The MIT License (MIT). Please see [License File](LICENSE) for more information.

composer.json

@@ -0,0 +1,33 @@
+{
+    "name": "php-http/message-factory",
+    "description": "Factory interfaces for PSR-7 HTTP Message",
+    "license": "MIT",
+    "keywords": ["http", "factory", "message", "stream", "uri"],
+    "homepage": "http://php-http.org",
+    "authors": [
+        {
+            "name": "Eric GELOEN",
+            "email": "[email protected]"
+        },
+        {
+            "name": "Márk Sági-Kazár",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "php": ">=5.4",
+        "psr/http-message": "^0.11"
+    },
+    "autoload": {
+        "psr-4": {
+            "Http\\Message\\": "src/"
+        }
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "0.1-dev"
+        }
+    },
+    "prefer-stable": true,
+    "minimum-stability": "dev"
+}

src/MessageFactory.php

@@ -0,0 +1,61 @@
+<?php
+
+/*
+ * This file is part of the Http Message Factory package.
+ *
+ * (c) PHP HTTP Team
+ *
+ * For the full copyright and license information, please read the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Http\Message;
+
+use Psr\Http\Message\UriInterface;
+use Psr\Http\Message\RequestInterface;
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\StreamInterface;
+
+/**
+ * @author Márk Sági-Kazár <[email protected]>
+ */
+interface MessageFactory
+{
+    /**
+     * Creates a new request
+     *
+     * @param string                               $method
+     * @param string|UriInterface                  $uri
+     * @param string                               $protocolVersion
+     * @param string[]                             $headers
+     * @param resource|string|StreamInterface|null $body
+     *
+     * @return RequestInterface
+     */
+    public function createRequest(
+        $method,
+        $uri,
+        $protocolVersion = '1.1',
+        array $headers = [],
+        $body = null
+    );
+
+    /**
+     * Creates a response
+     *
+     * @param integer                              $statusCode
+     * @param string|null                          $reasonPhrase
+     * @param string                               $protocolVersion
+     * @param string[]                             $headers
+     * @param resource|string|StreamInterface|null $body
+     *
+     * @return ResponseInterface
+     */
+    public function createResponse(
+        $statusCode = 200,
+        $reasonPhrase = null
+        $protocolVersion = '1.1',
+        array $headers = [],
+        $body = null
+    );
+}

src/MessageFactoryAware.php

@@ -0,0 +1,32 @@
+<?php
+
+/*
+ * This file is part of the Http Message Factory package.
+ *
+ * (c) PHP HTTP Team
+ *
+ * For the full copyright and license information, please read the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Http\Message;
+
+/**
+ * @author Márk Sági-Kazár <[email protected]>
+ */
+interface MessageFactoryAware
+{
+    /**
+     * Returns a Message Factory
+     *
+     * @return MessageFactory
+     */
+    public function getMessageFactory();
+
+    /**
+     * Sets a Message Factory
+     *
+     * @param MessageFactory $messageFactory
+     */
+    public function setMessageFactory(MessageFactory $messageFactory);
+}

src/MessageFactoryHelper.php

@@ -0,0 +1,39 @@
+<?php
+
+/*
+ * This file is part of the Http Message Factory package.
+ *
+ * (c) PHP HTTP Team
+ *
+ * For the full copyright and license information, please read the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Http\Message;
+
+/**
+ * @author Márk Sági-Kazár <[email protected]>
+ */
+interface MessageFactoryHelper
+{
+    /**
+     * @var MessageFactory
+     */
+    protected $messageFactory;
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getMessageFactory()
+    {
+        return $this->messageFactory;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function setMessageFactory(MessageFactory $messageFactory)
+    {
+        $this->messageFactory = $messageFactory;
+    }
+}