├── src
    ├── UriFactoryInterface.php
    ├── RequestFactoryInterface.php
    ├── ResponseFactoryInterface.php
    ├── ServerRequestFactoryInterface.php
    ├── UploadedFileFactoryInterface.php
    └── StreamFactoryInterface.php
├── README.md
├── composer.json
└── LICENSE


/src/UriFactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Psr\Http\Message;
 4 | 
 5 | interface UriFactoryInterface
 6 | {
 7 |     /**
 8 |      * Create a new URI.
 9 |      *
10 |      * @param string $uri
11 |      *
12 |      * @return UriInterface
13 |      *
14 |      * @throws \InvalidArgumentException If the given URI cannot be parsed.
15 |      */
16 |     public function createUri(string $uri = ''): UriInterface;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/RequestFactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Psr\Http\Message;
 4 | 
 5 | interface RequestFactoryInterface
 6 | {
 7 |     /**
 8 |      * Create a new request.
 9 |      *
10 |      * @param string $method The HTTP method associated with the request.
11 |      * @param UriInterface|string $uri The URI associated with the request. If
12 |      *     the value is a string, the factory MUST create a UriInterface
13 |      *     instance based on it.
14 |      *
15 |      * @return RequestInterface
16 |      */
17 |     public function createRequest(string $method, $uri): RequestInterface;
18 | }
19 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | HTTP Factories
 2 | ==============
 3 | 
 4 | This repository holds all interfaces related to [PSR-17 (HTTP Factories)][psr-url].
 5 | 
 6 | Note that this is not a HTTP Factory implementation of its own. It is merely interfaces that describe the components of a HTTP Factory.
 7 | 
 8 | The installable [package][package-url] and [implementations][implementation-url] are listed on Packagist.
 9 | 
10 | [psr-url]: https://www.php-fig.org/psr/psr-17/
11 | [package-url]: https://packagist.org/packages/psr/http-factory
12 | [implementation-url]: https://packagist.org/providers/psr/http-factory-implementation
13 | 


--------------------------------------------------------------------------------
/src/ResponseFactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Psr\Http\Message;
 4 | 
 5 | interface ResponseFactoryInterface
 6 | {
 7 |     /**
 8 |      * Create a new response.
 9 |      *
10 |      * @param int $code HTTP status code; defaults to 200
11 |      * @param string $reasonPhrase Reason phrase to associate with status code
12 |      *     in generated response; if none is provided implementations MAY use
13 |      *     the defaults as suggested in the HTTP specification.
14 |      *
15 |      * @return ResponseInterface
16 |      */
17 |     public function createResponse(int $code = 200, string $reasonPhrase = ''): ResponseInterface;
18 | }
19 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "psr/http-factory",
 3 |     "description": "PSR-17: Common interfaces for PSR-7 HTTP message factories",
 4 |     "keywords": [
 5 |         "psr",
 6 |         "psr-7",
 7 |         "psr-17",
 8 |         "http",
 9 |         "factory",
10 |         "message",
11 |         "request",
12 |         "response"
13 |     ],
14 |     "license": "MIT",
15 |     "authors": [
16 |         {
17 |             "name": "PHP-FIG",
18 |             "homepage": "https://www.php-fig.org/"
19 |         }
20 |     ],
21 |     "support": {
22 |         "source": "https://github.com/php-fig/http-factory"
23 |     },
24 |     "require": {
25 |         "php": ">=7.1",
26 |         "psr/http-message": "^1.0 || ^2.0"
27 |     },
28 |     "autoload": {
29 |         "psr-4": {
30 |             "Psr\\Http\\Message\\": "src/"
31 |         }
32 |     },
33 |     "extra": {
34 |         "branch-alias": {
35 |             "dev-master": "1.0.x-dev"
36 |         }
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/ServerRequestFactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Psr\Http\Message;
 4 | 
 5 | interface ServerRequestFactoryInterface
 6 | {
 7 |     /**
 8 |      * Create a new server request.
 9 |      *
10 |      * Note that server-params are taken precisely as given - no parsing/processing
11 |      * of the given values is performed, and, in particular, no attempt is made to
12 |      * determine the HTTP method or URI, which must be provided explicitly.
13 |      *
14 |      * @param string $method The HTTP method associated with the request.
15 |      * @param UriInterface|string $uri The URI associated with the request. If
16 |      *     the value is a string, the factory MUST create a UriInterface
17 |      *     instance based on it.
18 |      * @param array $serverParams Array of SAPI parameters with which to seed
19 |      *     the generated request instance.
20 |      *
21 |      * @return ServerRequestInterface
22 |      */
23 |     public function createServerRequest(string $method, $uri, array $serverParams = []): ServerRequestInterface;
24 | }
25 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2018 PHP-FIG
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/src/UploadedFileFactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Psr\Http\Message;
 4 | 
 5 | interface UploadedFileFactoryInterface
 6 | {
 7 |     /**
 8 |      * Create a new uploaded file.
 9 |      *
10 |      * If a size is not provided it will be determined by checking the size of
11 |      * the file.
12 |      *
13 |      * @see http://php.net/manual/features.file-upload.post-method.php
14 |      * @see http://php.net/manual/features.file-upload.errors.php
15 |      *
16 |      * @param StreamInterface $stream Underlying stream representing the
17 |      *     uploaded file content.
18 |      * @param int|null $size in bytes
19 |      * @param int $error PHP file upload error
20 |      * @param string|null $clientFilename Filename as provided by the client, if any.
21 |      * @param string|null $clientMediaType Media type as provided by the client, if any.
22 |      *
23 |      * @return UploadedFileInterface
24 |      *
25 |      * @throws \InvalidArgumentException If the file resource is not readable.
26 |      */
27 |     public function createUploadedFile(
28 |         StreamInterface $stream,
29 |         ?int $size = null,
30 |         int $error = \UPLOAD_ERR_OK,
31 |         ?string $clientFilename = null,
32 |         ?string $clientMediaType = null
33 |     ): UploadedFileInterface;
34 | }
35 | 


--------------------------------------------------------------------------------
/src/StreamFactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Psr\Http\Message;
 4 | 
 5 | interface StreamFactoryInterface
 6 | {
 7 |     /**
 8 |      * Create a new stream from a string.
 9 |      *
10 |      * The stream SHOULD be created with a temporary resource.
11 |      *
12 |      * @param string $content String content with which to populate the stream.
13 |      *
14 |      * @return StreamInterface
15 |      */
16 |     public function createStream(string $content = ''): StreamInterface;
17 | 
18 |     /**
19 |      * Create a stream from an existing file.
20 |      *
21 |      * The file MUST be opened using the given mode, which may be any mode
22 |      * supported by the `fopen` function.
23 |      *
24 |      * The `$filename` MAY be any string supported by `fopen()`.
25 |      *
26 |      * @param string $filename Filename or stream URI to use as basis of stream.
27 |      * @param string $mode Mode with which to open the underlying filename/stream.
28 |      *
29 |      * @return StreamInterface
30 |      * @throws \RuntimeException If the file cannot be opened.
31 |      * @throws \InvalidArgumentException If the mode is invalid.
32 |      */
33 |     public function createStreamFromFile(string $filename, string $mode = 'r'): StreamInterface;
34 | 
35 |     /**
36 |      * Create a new stream from an existing resource.
37 |      *
38 |      * The stream MUST be readable and may be writable.
39 |      *
40 |      * @param resource $resource PHP resource to use as basis of stream.
41 |      *
42 |      * @return StreamInterface
43 |      */
44 |     public function createStreamFromResource($resource): StreamInterface;
45 | }
46 | 


--------------------------------------------------------------------------------