Move ServerRequest class to React\Http\Message\ServerRequest

Author: clue

README.md

@@ -70,6 +70,7 @@ multiple concurrent HTTP requests without blocking.
         * [withResponseBuffer()](#withresponsebuffer)
     * [React\Http\Message](#reacthttpmessage)
         * [Response](#response)
+        * [ServerRequest](#serverrequest)
     * [React\Http\Middleware](#reacthttpmiddleware)
         * [StreamingRequestMiddleware](#streamingrequestmiddleware)
         * [LimitConcurrentRequestsMiddleware](#limitconcurrentrequestsmiddleware)
@@ -2356,6 +2357,26 @@ which in turn extends the
   of ReactPHPs `ReadableStreamInterface` for the `$body` argument. This base
   class is considered an implementation detail that may change in the future.
 
+#### ServerRequest
+
+The `ServerRequest` class can be used to
+respresent an incoming server request message.
+
+This class implements the
+[PSR-7 `ServerRequestInterface`](https://www.php-fig.org/psr/psr-7/#321-psrhttpmessageserverrequestinterface)
+which extends the
+[PSR-7 `RequestInterface`](https://www.php-fig.org/psr/psr-7/#32-psrhttpmessagerequestinterface)
+which in turn extends the
+[PSR-7 `MessageInterface`](https://www.php-fig.org/psr/psr-7/#31-psrhttpmessagemessageinterface).
+
+This is mostly used internally to represent each incoming request message.
+Likewise, you can also use this class in test cases to test how your web
+application reacts to certain HTTP requests.
+
+> Internally, this implementation builds on top of an existing outgoing
+  request message and only adds required server methods. This base class is
+  considered an implementation detail that may change in the future.
+
 ### React\Http\Middleware
 
 #### StreamingRequestMiddleware

src/Io/RequestHeaderParser.php

@@ -4,6 +4,7 @@
 
 use Evenement\EventEmitter;
 use Psr\Http\Message\ServerRequestInterface;
+use React\Http\Message\ServerRequest;
 use React\Socket\ConnectionInterface;
 use Exception;
 

src/Io/StreamingServer.php

@@ -7,6 +7,7 @@
 use Psr\Http\Message\ServerRequestInterface;
 use React\EventLoop\LoopInterface;
 use React\Http\Message\Response;
+use React\Http\Message\ServerRequest;
 use React\Promise;
 use React\Promise\CancellablePromiseInterface;
 use React\Promise\PromiseInterface;

src/Io/ServerRequest.php src/Message/ServerRequest.phpsrc/Io/ServerRequest.php renamed to src/Message/ServerRequest.php

@@ -1,25 +1,31 @@
 <?php
 
-namespace React\Http\Io;
+namespace React\Http\Message;
 
 use Psr\Http\Message\ServerRequestInterface;
 use Psr\Http\Message\StreamInterface;
 use Psr\Http\Message\UriInterface;
 use RingCentral\Psr7\Request;
 
 /**
- * [Internal] Implementation of the PSR-7 `ServerRequestInterface`
+ * Respresents an incoming server request message.
  *
- * This is used internally to represent each incoming request message.
+ * This class implements the
+ * [PSR-7 `ServerRequestInterface`](https://www.php-fig.org/psr/psr-7/#321-psrhttpmessageserverrequestinterface)
+ * which extends the
+ * [PSR-7 `RequestInterface`](https://www.php-fig.org/psr/psr-7/#32-psrhttpmessagerequestinterface)
+ * which in turn extends the
+ * [PSR-7 `MessageInterface`](https://www.php-fig.org/psr/psr-7/#31-psrhttpmessagemessageinterface).
  *
- * This implementation builds on top of an existing outgoing request message and
- * only adds required server methods.
+ * This is mostly used internally to represent each incoming request message.
+ * Likewise, you can also use this class in test cases to test how your web
+ * application reacts to certain HTTP requests.
  *
- * Note that this is an internal class only and nothing you should usually care
- * about. See the `ServerRequestInterface` for more details.
+ * > Internally, this implementation builds on top of an existing outgoing
+ *   request message and only adds required server methods. This base class is
+ *   considered an implementation detail that may change in the future.
  *
  * @see ServerRequestInterface
- * @internal
  */
 class ServerRequest extends Request implements ServerRequestInterface
 {

tests/Io/MiddlewareRunnerTest.php

@@ -3,18 +3,18 @@
 namespace React\Tests\Http\Io;
 
 use Clue\React\Block;
+use Psr\Http\Message\RequestInterface;
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 use React\EventLoop\Factory;
 use React\Http\Io\MiddlewareRunner;
-use React\Http\Io\ServerRequest;
+use React\Http\Message\ServerRequest;
 use React\Promise;
+use React\Promise\CancellablePromiseInterface;
+use React\Promise\PromiseInterface;
 use React\Tests\Http\Middleware\ProcessStack;
 use React\Tests\Http\TestCase;
 use RingCentral\Psr7\Response;
-use Psr\Http\Message\RequestInterface;
-use React\Promise\CancellablePromiseInterface;
-use React\Promise\PromiseInterface;
 
 final class MiddlewareRunnerTest extends TestCase
 {

tests/Io/MultipartParserTest.php

@@ -3,7 +3,7 @@
 namespace React\Tests\Http\Io\Middleware;
 
 use React\Http\Io\MultipartParser;
-use React\Http\Io\ServerRequest;
+use React\Http\Message\ServerRequest;
 use React\Tests\Http\TestCase;
 
 final class MultipartParserTest extends TestCase

tests/Io/StreamingServerTest.php

@@ -3,8 +3,8 @@
 namespace React\Tests\Http\Io;
 
 use Psr\Http\Message\ServerRequestInterface;
-use React\Http\Io\StreamingServer;
 use React\EventLoop\Factory;
+use React\Http\Io\StreamingServer;
 use React\Http\Message\Response;
 use React\Promise\Promise;
 use React\Stream\ThroughStream;

tests/Io/ServerRequestTest.php tests/Message/ServerRequestTest.phptests/Io/ServerRequestTest.php renamed to tests/Message/ServerRequestTest.php

@@ -1,8 +1,8 @@
 <?php
 
-namespace React\Tests\Http\Io;
+namespace React\Tests\Http\Message;
 
-use React\Http\Io\ServerRequest;
+use React\Http\Message\ServerRequest;
 use React\Tests\Http\TestCase;
 
 class ServerRequestTest extends TestCase

tests/Middleware/LimitConcurrentRequestsMiddlewareTest.php

@@ -4,14 +4,14 @@
 
 use Psr\Http\Message\ServerRequestInterface;
 use React\Http\Io\HttpBodyStream;
-use React\Http\Io\ServerRequest;
+use React\Http\Message\Response;
+use React\Http\Message\ServerRequest;
 use React\Http\Middleware\LimitConcurrentRequestsMiddleware;
 use React\Promise\Deferred;
 use React\Promise\Promise;
+use React\Promise\PromiseInterface;
 use React\Stream\ThroughStream;
 use React\Tests\Http\TestCase;
-use React\Promise\PromiseInterface;
-use React\Http\Message\Response;
 
 final class LimitConcurrentRequestsMiddlewareTest extends TestCase
 {

tests/Middleware/RequestBodyBufferMiddlewareTest.php

@@ -6,9 +6,9 @@
 use Psr\Http\Message\ServerRequestInterface;
 use React\EventLoop\Factory;
 use React\Http\Io\HttpBodyStream;
-use React\Http\Io\ServerRequest;
-use React\Http\Middleware\RequestBodyBufferMiddleware;
 use React\Http\Message\Response;
+use React\Http\Message\ServerRequest;
+use React\Http\Middleware\RequestBodyBufferMiddleware;
 use React\Stream\ThroughStream;
 use React\Tests\Http\TestCase;
 use RingCentral\Psr7\BufferStream;