Download the PHP package pdeans/http without Composer
On this page you can find all versions of the php package pdeans/http. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package http
HTTP Client Library
Lightweight PSR-7 HTTP message interfaces cURL client with support for PSR-17 HTTP factories interfaces.
Installation
Install via Composer.
Usage
The cURL client is built on top of the Laminas Diactoros PSR-7 and PSR-17 implementations.
Configuring the Client
The client accepts an optional associative array of curl options as the first parameter to configure the cURL client. Please note that the following cURL options cannot be set in order to comply with PSR-7 standards. Instead, these options should be provided as part of the request options:
- CURLOPT_CUSTOMREQUEST
- CURLOPT_FOLLOWLOCATION
- CURLOPT_HEADER
- CURLOPT_HTTP_VERSION
- CURLOPT_HTTPHEADER
- CURLOPT_NOBODY
- CURLOPT_POSTFIELDS
- CURLOPT_RETURNTRANSFER
- CURLOPT_URL
- CURLOPT_USERPWD
The following is an example of how to create and configure the client:
HTTP Requests
The client comes bundled with helper methods to provide a convenient way for issuing the supported HTTP request methods.
GET
, HEAD
, and TRACE
methods take the following parameters:
- String representation of the target url OR a class instance that implements the PSR-7
Psr\Http\Message\UriInterface
. - Associative array of headers
[headerName => headerValue]
.
POST
, PUT
, PATCH
, OPTIONS
, and DELETE
methods take the two parameters listed above, plus an optional 3rd parameter for the request body:
- String of request body data OR a class instance that implements the PSR-7
Psr\Http\Message\StreamInterface
OR aresource
.
Request Usage
If more control over the request is needed, the helper methods can be bypassed and the sendRequest
method may be called directly. This method accepts a class instance that implements the PSR-7 Psr\Http\Message\RequestInterface
.
Example GET
request using the RequestFactory
class instance:
Example POST
request using the Request
class instance:
HTTP Responses
Each HTTP request returns a pdeans\Http\Response
class instance, which is an implementation of the PSR-7 Psr\Http\Message\ResponseInterface
.
Response Usage
PSR-17 Factories
The following HTTP factory classes are available and each implement their associated PSR-17 factory interface:
pdeans\Http\Factories\RequestFactory
implementsPsr\Http\Message\RequestFactoryInterface
pdeans\Http\Factories\ResponseFactory
implementsPsr\Http\Message\ResponseFactoryInterface
pdeans\Http\Factories\ServerRequestFactory
implementsPsr\Http\Message\ServerRequestFactoryInterface
pdeans\Http\Factories\StreamFactory
implementsPsr\Http\Message\StreamFactoryInterface
pdeans\Http\Factories\UploadedFileFactory
implementsPsr\Http\Message\UploadedFileFactoryInterface
pdeans\Http\Factories\UriFactory
implementsPsr\Http\Message\UriFactoryInterface
Factory Usage
Further Reading
As this library is a layer built upon existing libraries and standards, it is encouraged that you read through the documentation of these libraries and standards to get a better understanding of how the various components work.