Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/initphp/http
This library provides HTTP Message and HTTP Factory solution following PSR-7 and PSR-17 standards. It also includes an Emitter class for the PSR-7.
https://github.com/initphp/http
emitter http-emitter http-message php php-http php7 psr-17 psr-7 psr7-handler psr7-http psr7-request psr7-response
Last synced: about 2 months ago
JSON representation
This library provides HTTP Message and HTTP Factory solution following PSR-7 and PSR-17 standards. It also includes an Emitter class for the PSR-7.
- Host: GitHub
- URL: https://github.com/initphp/http
- Owner: InitPHP
- License: mit
- Created: 2022-03-15T09:33:26.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-26T14:45:09.000Z (over 1 year ago)
- Last Synced: 2024-11-18T09:43:03.176Z (2 months ago)
- Topics: emitter, http-emitter, http-message, php, php-http, php7, psr-17, psr-7, psr7-handler, psr7-http, psr7-request, psr7-response
- Language: PHP
- Homepage:
- Size: 55.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# InitPHP HTTP
This library provides HTTP Message and HTTP Factory solution following PSR-7 and PSR-17 standards. It also includes an Emitter class for the PSR-7.
[](https://packagist.org/packages/initphp/http) [](https://packagist.org/packages/initphp/http) [](https://packagist.org/packages/initphp/http) [](https://packagist.org/packages/initphp/http) [](https://packagist.org/packages/initphp/http)
## Requirements
- PHP 7.4 or higher
- PSR-7 HTTP Message Interfaces
- PSR-17 HTTP Factories Interfaces
- PSR-18 HTTP Client Interfaces
## Installation
```
composer require initphp/http
```
## Usage
It adheres to the PSR-7, PSR-17, PSR-18 standards and strictly implements these interfaces to a large extent.
### PSR-7 Emitter Usage
```php
use \InitPHP\HTTP\Message\{Response, Stream};
use \InitPHP\HTTP\Emitter\Emitter;
$response = new Response(200, [], new Stream('Hello World', null), '1.1');
$emitter = new Emitter();
$emitter->emit($response);
```
or
```php
use \InitPHP\HTTP\Facade\Factory;
use \InitPHP\HTTP\Facade\Emitter;
$response = Factory::createResponse(200);
$response->getBody()->write('Hello World');
Emitter::emit($response);
```
### PSR-17 Factory Usage
```php
use \InitPHP\HTTP\Factory\Factory;
$httpFactory = new Factory();
/** @var \Psr\Http\Message\RequestInterface $request */
$request = $httpFactory->createRequest('GET', 'http://example.com');
// ...
```
or
```php
use InitPHP\HTTP\Facade\Factory;
/** @var \Psr\Http\Message\RequestInterface $request */
$request = Factory::createRequest('GET', 'http://example.com');
```
### PSR-18 Client Usage
```php
use \InitPHP\HTTP\Message\Request;
use \InitPHP\HTTP\Client\Client;
$request = new Request('GET', 'http://example.com');
$client = new Client();
/** @var \Psr\Http\Message\ResponseInterface $response */
$response = $client->sendRequest($request);
```
or
```php
use \InitPHP\HTTP\Facade\Factory;
use \InitPHP\HTTP\Facade\Client;
$request = Factory::createRequest('GET', 'http://example.com');
/** @var \Psr\Http\Message\ResponseInterface $response */
$response = Client::sendRequest($request);
```
#### A Small Difference For PSR-7 Stream
If you are working with small content; The PSR-7 Stream interface may be cumbersome for you. This is because the PSR-7 stream interface writes the content "`php://temp`" or "`php://memory`". By default this library will also overwrite `php://temp` with your content. To change this behavior, this must be declared as the second parameter to the constructor method when creating the Stream object.
```php
use \InitPHP\HTTP\Stream;
/**
* This content is kept in memory as a variable.
*/
$variableStream = new Stream('String Content', null);
/**
* Content; "php://memory" is overwritten.
*/
$memoryStream = new Stream('Content', 'php://memory');
/**
* Content; "php://temp" is overwritten.
*/
$tempStream = new Stream('Content', 'php://temp');
// or new Stream('Content');
```
## Credits
- [Muhammet ŞAFAK](https://www.muhammetsafak.com.tr) <>
## License
Copyright © 2022 [MIT License](./LICENSE)