https://github.com/alexpts/php-mutable-psr7

A super lightweight PSR-7 implementation (muttable)
https://github.com/alexpts/php-mutable-psr7

php psr-7

Last synced: 2 months ago
JSON representation

A super lightweight PSR-7 implementation (muttable)

• Host: GitHub
• URL: https://github.com/alexpts/php-mutable-psr7
• Owner: alexpts
• Created: 2020-06-07T08:19:11.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-11-06T16:01:25.000Z (3 months ago)
• Last Synced: 2024-11-13T18:16:20.681Z (2 months ago)
• Topics: php, psr-7
• Language: PHP
• Homepage:
• Size: 107 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
[![Build Status](https://app.travis-ci.com/alexpts/php-mutable-psr7.svg?branch=master)](https://app.travis-ci.com/alexpts/php-mutable-psr7)

[![Code Coverage](https://scrutinizer-ci.com/g/alexpts/php-mutable-psr7/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/alexpts/php-mutable-psr7/?branch=master)

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/alexpts/php-mutable-psr7/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/alexpts/php-mutable-psr7/?branch=master)

### Mutable

The package is based on https://github.com/Nyholm/psr7/. The package is mutable. If you need immutable implementation please to see `nyholm/psr7`.

A super lightweight PSR-7 implementation. Very strict and very fast.

## Installation

```bash

composer require alexpts/mutable-psr7

```

If you are using Symfony Flex then you get all message factories registered as services.

## Usage

The PSR-7 objects do not contain any other public methods than those defined in

the [PSR-7 specification](https://www.php-fig.org/psr/psr-7/).

### Create objects

Use the PSR-17 factory to create requests, streams, URIs etc.

```php

$psr17Factory = new \PTS\Psr7\Factory\Psr17Factory();

$request = $psr17Factory->createRequest('GET', 'http://some.com');

$stream = $psr17Factory->createStream('foobar');

```

### Sending a request

With [HTTPlug](http://httplug.io/) or any other PSR-18 (HTTP client) you may send

requests like:

```bash

composer require kriswallsmith/buzz

```

```php

$psr17Factory = new \PTS\Psr7\Factory\Psr17Factory();

$psr18Client = new \Buzz\Client\Curl($psr17Factory);

$request = $psr17Factory->createRequest('GET', 'http://some.com');

$response = $psr18Client->sendRequest($request);

```

### Create server requests

The [`nyholm/psr7-server`](https://github.com/Nyholm/psr7-server) package can be used

to create server requests from PHP superglobals.

```bash

composer require nyholm/psr7-server

```

```php

$psr17Factory = new \PTS\Psr7\Factory\Psr17Factory();

$creator = new \Nyholm\Psr7Server\ServerRequestCreator(

    $psr17Factory, // ServerRequestFactory

    $psr17Factory, // UriFactory

    $psr17Factory, // UploadedFileFactory

    $psr17Factory  // StreamFactory

);

$serverRequest = $creator->fromGlobals();

```

### Emitting a response

```bash

composer require laminas/laminas-httphandlerrunner

```

```php

$psr17Factory = new \PTS\Psr7\Factory\Psr17Factory();

$responseBody = $psr17Factory->createStream('Hello world');

$response = $psr17Factory->createResponse(200)->withBody($responseBody);

(new \Laminas\HttpHandlerRunner\Emitter\SapiEmitter())->emit($response);

```

### Benchmark Tests

`composer bench`