Add headers parsing

README.md

@@ -20,87 +20,10 @@ The package provides:
 - PSR-7, PSR-17 PhpStorm meta for HTTP protocol headers, methods and statuses.
 - `ContentDispositionHeader` that has static methods to generate `Content-Disposition` header name and value.
 
-## Method constants
+## Documentation
 
-Individual HTTP methods could be referenced as
-
-```php
-use Yiisoft\Http\Method;
-
-Method::GET;
-Method::POST;
-Method::PUT;
-Method::DELETE;
-Method::PATCH;
-Method::HEAD;
-Method::OPTIONS;
-```
-
-To have a list of these, use:
-
-```php
-use Yiisoft\Http\Method;
-
-Method::ALL;
-```
-
-## HTTP status codes
-
-Status codes could be referenced by name as:
-
-```php
-use Yiisoft\Http\Status;
-
-Status::NOT_FOUND;
-```
-
-Status text could be obtained as the following:
-
-```php
-use Yiisoft\Http\Status;
-
-Status::TEXTS[Status::NOT_FOUND];
-```
-
-## `ContentDispositionHeader` usage
-
-`ContentDispositionHeader` methods are static so usage is like the following:
-
-```php
-$name = \Yiisoft\Http\ContentDispositionHeader::name();
-
-$value = \Yiisoft\Http\ContentDispositionHeader::value(
-    \Yiisoft\Http\ContentDispositionHeader::INLINE,
-     'avatar.png'
-);
-
-$value = \Yiisoft\Http\ContentDispositionHeader::inline('document.pdf');
-
-$value = \Yiisoft\Http\ContentDispositionHeader::attachment('document.pdf');
-```
-
-## PSR-7 and PSR-17 PhpStorm meta
-
-The package includes PhpStorm meta-files that help IDE to provide values when completing code in cases such as:
-
-```php
-use Psr\Http\Message\ResponseFactoryInterface;
-use Psr\Http\Message\ResponseInterface;
-use Yiisoft\Http\Header;
-use Yiisoft\Http\Status;
-
-class StaticController
-{
-    private ResponseFactoryInterface $responseFactory;
-
-    public function actionIndex(): ResponseInterface
-    {
-        return $this->responseFactory->createResponse()
-            ->withStatus(Status::OK)
-            ->withoutHeader(Header::ACCEPT);
-    }
-}
-```
+- [English](docs/en/README.md)
+- [Russian](docs/ru/README.md)
 
 ## Testing
 

composer.json

@@ -21,6 +21,7 @@
     },
     "require": {
         "php": "^7.4|^8.0",
+        "psr/http-message": "^1.0",
         "yiisoft/strings": "^2.0"
     },
     "autoload": {

docs/en/README.md

@@ -0,0 +1,18 @@
+# HTTP Package
+
+All HTTP/1.1 messages consist of a start-line followed by a sequence of octets in a format similar to the Internet
+Message Format [RFC5322](https://tools.ietf.org/html/rfc5322): zero or more header fields (collectively referred to as
+the "headers" or the "header section"), an empty line indicating the end of the header section, and an optional message
+body.
+
+- [HTTP start line](http-start-line.md) (Method constants and status codes)
+- [HTTP headers](http-headers.md)
+
+Related links to RFC:
+
+* [RFC7230](https://tools.ietf.org/html/rfc7230) HTTP/1.1: Message Syntax and Routing
+* [RFC7231](https://tools.ietf.org/html/rfc7231) HTTP/1.1: Semantics and Content
+* [RFC7232](https://tools.ietf.org/html/rfc7232) HTTP/1.1: Conditional Requests
+* [RFC7233](https://tools.ietf.org/html/rfc7233) HTTP/1.1: Range Requests
+* [RFC7234](https://tools.ietf.org/html/rfc7234) HTTP/1.1: Caching
+* [RFC7235](https://tools.ietf.org/html/rfc7235) HTTP/1.1: Authentication

docs/en/http-start-line.md

@@ -0,0 +1,87 @@
+# HTTP start line
+
+An HTTP message can be either a request from client to server or a response from server to client.  Syntactically, the
+two types of message differ in the start-line, which is either a request-line (for requests) or a status-line
+(for responses).
+
+## Method constants
+
+Individual HTTP methods could be referenced as
+
+```php
+use Yiisoft\Http\Method;
+
+Method::GET;
+Method::POST;
+Method::PUT;
+Method::DELETE;
+Method::PATCH;
+Method::HEAD;
+Method::OPTIONS;
+```
+
+To have a list of these, use:
+
+```php
+use Yiisoft\Http\Method;
+
+Method::ALL;
+```
+
+## HTTP status codes
+
+Status codes could be referenced by name as:
+
+```php
+use Yiisoft\Http\Status;
+
+Status::NOT_FOUND;
+```
+
+Status text could be obtained as the following:
+
+```php
+use Yiisoft\Http\Status;
+
+Status::TEXTS[Status::NOT_FOUND];
+```
+
+# ContentDispositionHeader usage
+
+`ContentDispositionHeader` methods are static so usage is like the following:
+
+```php
+$name = \Yiisoft\Http\ContentDispositionHeader::name();
+
+$value = \Yiisoft\Http\ContentDispositionHeader::value(
+    \Yiisoft\Http\ContentDispositionHeader::INLINE,
+     'avatar.png'
+);
+
+$value = \Yiisoft\Http\ContentDispositionHeader::inline('document.pdf');
+
+$value = \Yiisoft\Http\ContentDispositionHeader::attachment('document.pdf');
+```
+
+# PSR-7 and PSR-17 PhpStorm meta
+
+The package includes PhpStorm meta-files that help IDE to provide values when completing code in cases such as:
+
+```php
+use Psr\Http\Message\ResponseFactoryInterface;
+use Psr\Http\Message\ResponseInterface;
+use Yiisoft\Http\Header;
+use Yiisoft\Http\Status;
+
+class StaticController
+{
+    private ResponseFactoryInterface $responseFactory;
+
+    public function actionIndex(): ResponseInterface
+    {
+        return $this->responseFactory->createResponse()
+            ->withStatus(Status::OK)
+            ->withoutHeader(Header::ACCEPT);
+    }
+}
+```

docs/ru/README.md

@@ -0,0 +1,18 @@
+# HTTP Package
+
+All HTTP/1.1 messages consist of a start-line followed by a sequence of octets in a format similar to the Internet
+Message Format [RFC5322](https://tools.ietf.org/html/rfc5322): zero or more header fields (collectively referred to as
+the "headers" or the "header section"), an empty line indicating the end of the header section, and an optional message
+body.
+
+- [HTTP start line](http-start-line.md) (Method constants and status codes)
+- [HTTP заголовки](http-headers.md)
+
+Ссылки на RFC:
+
+* [RFC7230](https://tools.ietf.org/html/rfc7230) HTTP/1.1: Message Syntax and Routing
+* [RFC7231](https://tools.ietf.org/html/rfc7231) HTTP/1.1: Semantics and Content
+* [RFC7232](https://tools.ietf.org/html/rfc7232) HTTP/1.1: Conditional Requests
+* [RFC7233](https://tools.ietf.org/html/rfc7233) HTTP/1.1: Range Requests
+* [RFC7234](https://tools.ietf.org/html/rfc7234) HTTP/1.1: Caching
+* [RFC7235](https://tools.ietf.org/html/rfc7235) HTTP/1.1: Authentication