Vue File Manager Pro - v2.2.0.2.zip

# HTTP [](https://github.com/reactphp/http/actions) Event-driven, streaming HTTP client and server implementation for [ReactPHP](https://reactphp.org/). This HTTP library provides re-usable implementations for an HTTP client and server based on ReactPHP's [`Socket`](https://github.com/reactphp/socket) and [`EventLoop`](https://github.com/reactphp/event-loop) components. Its client component allows you to send any number of async HTTP/HTTPS requests concurrently. Its server component allows you to build plaintext HTTP and secure HTTPS servers that accept incoming HTTP requests from HTTP clients (such as web browsers). This library provides async, streaming means for all of this, so you can handle multiple concurrent HTTP requests without blocking. **Table of contents** * [Quickstart example](#quickstart-example) * [Client Usage](#client-usage) * [Request methods](#request-methods) * [Promises](#promises) * [Cancellation](#cancellation) * [Timeouts](#timeouts) * [Authentication](#authentication) * [Redirects](#redirects) * [Blocking](#blocking) * [Concurrency](#concurrency) * [Streaming response](#streaming-response) * [Streaming request](#streaming-request) * [HTTP proxy](#http-proxy) * [SOCKS proxy](#socks-proxy) * [SSH proxy](#ssh-proxy) * [Unix domain sockets](#unix-domain-sockets) * [Server Usage](#server-usage) * [HttpServer](#httpserver) * [listen()](#listen) * [Server Request](#server-request) * [Request parameters](#request-parameters) * [Query parameters](#query-parameters) * [Request body](#request-body) * [Streaming incoming request](#streaming-incoming-request) * [Request method](#request-method) * [Cookie parameters](#cookie-parameters) * [Invalid request](#invalid-request) * [Server Response](#server-response) * [Deferred response](#deferred-response) * [Streaming outgoing response](#streaming-outgoing-response) * [Response length](#response-length) * [Invalid response](#invalid-response) * [Default response headers](#default-response-headers) * [Middleware](#middleware) * [Custom middleware](#custom-middleware) * [Third-Party Middleware](#third-party-middleware) * [API](#api) * [Browser](#browser) * [get()](#get) * [post()](#post) * [head()](#head) * [patch()](#patch) * [put()](#put) * [delete()](#delete) * [request()](#request) * [requestStreaming()](#requeststreaming) * [withTimeout()](#withtimeout) * [withFollowRedirects()](#withfollowredirects) * [withRejectErrorResponse()](#withrejecterrorresponse) * [withBase()](#withbase) * [withProtocolVersion()](#withprotocolversion) * [withResponseBuffer()](#withresponsebuffer) * [React\Http\Message](#reacthttpmessage) * [Response](#response) * [html()](#html) * [json()](#json) * [plaintext()](#plaintext) * [xml()](#xml) * [ServerRequest](#serverrequest) * [ResponseException](#responseexception) * [React\Http\Middleware](#reacthttpmiddleware) * [StreamingRequestMiddleware](#streamingrequestmiddleware) * [LimitConcurrentRequestsMiddleware](#limitconcurrentrequestsmiddleware) * [RequestBodyBufferMiddleware](#requestbodybuffermiddleware) * [RequestBodyParserMiddleware](#requestbodyparsermiddleware) * [Install](#install) * [Tests](#tests) * [License](#license) ## Quickstart example Once [installed](#install), you can use the following code to access an HTTP web server and send some simple HTTP GET requests: ```php <?php require __DIR__ . '/vendor/autoload.php'; $client = new React\Http\Browser(); $client->get('http://www.google.com/')->then(function (Psr\Http\Message\ResponseInterface $response) { var_dump($response->getHeaders(), (string)$response->getBody()); }, function (Exception $e) { echo 'Error: ' . $e->getMessage() . PHP_EOL; }); ``` This is an HTTP server which responds with `Hello World!` to every request. ```php <?php require __DIR__ . '/vendor/autoload.php'; $http = new React\Http\HttpServer(function (Psr\Http\Message\ServerRequestInterface $request) { return React\Http\Message\Response::plaintext( "Hello World!\n" ); }); $socket = new React\Socket\SocketServer('127.0.0.1:8080'); $http->listen($socket); ``` See also the [examples](examples/). ## Client Usage ### Request methods Most importantly, this project provides a [`Browser`](#browser) object that offers several methods that resemble the HTTP protocol methods: ```php $browser->get($url, array $headers = array()); $browser->head($url, array $headers = array()); $browser->post($url, array $headers = array(), string|ReadableStreamInterface $body = ''); $browser->delete($url, array $headers = array(), string|ReadableStreamInterface $body = ''); $browser->put($url, array $headers = array(), string|ReadableStreamInterface $body = ''); $browser->patch($url, array $headers = array(), string|ReadableStreamInterface $body = ''); ``` Each of these methods requires a `$url` and some optional parameters to send an HTTP request. Each of these method names matches the respective HTTP request method, for example the [`get()`](#get) method sends an HTTP `GET` request. You can optionally pass an associative array of additional `$headers` that will be sent with this HTTP request. Additionally, each method will automatically add a matching `Content-Length` request header if an outgoing request body is given and its size is known and non-empty. For an empty request body, if will only include a `Content-Length: 0` request header if the request method usually expects a request body (only applies to `POST`, `PUT` and `PATCH` HTTP request methods). If you're using a [streaming request body](#streaming-request), it will default to using `Transfer-Encoding: chunked` unless you explicitly pass in a matching `Content-Length` request header. See also [streaming request](#streaming-request) for more details. By default, all of the above methods default to sending requests using the HTTP/1.1 protocol version. If you want to explicitly use the legacy HTTP/1.0 protocol version, you can use the [`withProtocolVersion()`](#withprotocolversion) method. If you want to use any other or even custom HTTP request method, you can use the [`request()`](#request) method. Each of the above methods supports async operation and either *fulfills* with a [PSR-7 `ResponseInterface`](https://www.php-fig.org/psr/psr-7/#33-psrhttpmessageresponseinterface) or *rejects* with an `Exception`. Please see the following chapter about [promises](#promises) for more details. ### Promises Sending requests is async (non-blocking), so you can actually send multiple requests in parallel. The `Browser` will respond to each request with a [PSR-7 `ResponseInterface`](https://www.php-fig.org/psr/psr-7/#33-psrhttpmessageresponseinterface) message, the order is not guaranteed. Sending requests uses a [Promise](https://github.com/reactphp/promise)-based interface that makes it easy to react to when an HTTP request is completed (i.e. either successfully fulfilled or rejected with an error): ```php $browser->get($url)->then( function (Psr\Http\Message\ResponseInterface $response) { var_dump('Response received', $response); }, function (Exception $e) { echo 'Error: ' . $e->getMessage() . PHP_EOL; } ); ``` If this looks strange to you, you can also use the more traditional [blocking API](#blocking). Keep in mind that resolving the Promise with the full response message means the whole response body has to be kept in memory. This is easy to get started and works reasonably well for smaller responses (such as common HTML pages or RESTful or JSON AP