Slide 1

Slide 1 text

HTTP messages Modern way of dealing with HTTP in PHP @hannesvdvreken

Slide 2

Slide 2 text

Hi, my name is Hannes.

Slide 3

Slide 3 text

madewithlove

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

Highlighted packages

Slide 6

Slide 6 text

1. psr/http-message 2. guzzlehttp/guzzle 3. php-http/adapter

Slide 7

Slide 7 text

1. psr/http-message

Slide 8

Slide 8 text

PSR/HTTP-MESSAGE interfaces

Slide 9

Slide 9 text

PSR/HTTP-MESSAGE MessageInterface > RequestInterface > ResponseInterface UriInterface StreamInterface (body)

Slide 10

Slide 10 text

Differences with Symfony objects: Interfaces, not concretions PSR/HTTP-MESSAGE

Slide 11

Slide 11 text

Differences with Symfony objects: Interfaces, not concretions Immutable PSR/HTTP-MESSAGE

Slide 12

Slide 12 text

$newRequest = $request ->withHeader($name, $value); var_dump($newRequest === $request); > false PSR/HTTP-MESSAGE

Slide 13

Slide 13 text

PSR/HTTP-MESSAGE https:/ /github.com/php-fig/http-message/tree/master/src

Slide 14

Slide 14 text

2. guzzlehttp/guzzle

Slide 15

Slide 15 text

GUZZLEHTTP/GUZZLE composer require guzzlehttp/guzzle

Slide 16

Slide 16 text

GUZZLEHTTP/GUZZLE composer.json ^6.0

Slide 17

Slide 17 text

GUZZLEHTTP/GUZZLE composer.lock 6.0.2

Slide 18

Slide 18 text

GUZZLEHTTP/GUZZLE semver.mwl.be

Slide 19

Slide 19 text

No content

Slide 20

Slide 20 text

GUZZLEHTTP/GUZZLE What’s new?

Slide 21

Slide 21 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW PSR-7

Slide 22

Slide 22 text

GUZZLEHTTP/GUZZLE - PSR-7 guzzlehttp/psr7

Slide 23

Slide 23 text

GUZZLEHTTP/GUZZLE - PSR-7 "provide": { "psr/http-message-implementation": "1.0" },

Slide 24

Slide 24 text

GUZZLEHTTP/GUZZLE - PSR-7 use GuzzleHttp\Psr7\Request; $psrRequest = new Request( 'GET', $uri, $headers, $body );

Slide 25

Slide 25 text

GUZZLEHTTP/GUZZLE - PSR-7 $client = new GuzzleHttp\Client(); $client->send($psrRequest);

Slide 26

Slide 26 text

GUZZLEHTTP/GUZZLE - PSR-7 "require": { "php": ">=5.5.0", "guzzlehttp/psr7": "~1.1", }

Slide 27

Slide 27 text

GUZZLEHTTP/GUZZLE - PSR-7 Factories to convert $psrRequest ⁶ $symfonyRequest $psrResponse ⁶ $symfonyResponse

Slide 28

Slide 28 text

GUZZLEHTTP/GUZZLE - PSR-7 Demo https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/1-guzzle

Slide 29

Slide 29 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW What else?

Slide 30

Slide 30 text

GUZZLEHTTP/GUZZLE - PROMISES Promises

Slide 31

Slide 31 text

GUZZLEHTTP/GUZZLE - PROMISES Not so new: (>=5.0.0) Promises

Slide 32

Slide 32 text

GUZZLEHTTP/GUZZLE - PROMISES "require": { "php": ">=5.5.0", "guzzlehttp/psr7": "~1.1", "guzzlehttp/promise": "~1.0" }

Slide 33

Slide 33 text

GUZZLEHTTP/GUZZLE - PROMISES $promise = $client->sendAsync($request); $promise->then(function ($response) { $response->getBody(); }); $promise->wait();

Slide 34

Slide 34 text

GUZZLEHTTP/GUZZLE - PROMISES Demo https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/2-promise https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/3-multi

Slide 35

Slide 35 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW What else?

Slide 36

Slide 36 text

GUZZLEHTTP/GUZZLE - EVENTING Previously (<4.0.0) symfony/event-dispatcher Later (>=4.0.0, <6.0.0) GuzzleHttp\Event\EmitterInterface GuzzleHttp\Event\SubscriberInterface

Slide 37

Slide 37 text

GUZZLEHTTP/GUZZLE - MIDDLEWARES Now (>=6.0.0) Callable middlewares

Slide 38

Slide 38 text

GUZZLEHTTP/GUZZLE - MIDDLEWARES $stack = HandlerStack::create(); $client = new Client(['handler' => $stack]); $stack->push($middleware); $stack->unshift($middleware); $stack->remove($middleware);

Slide 39

Slide 39 text

GUZZLEHTTP/GUZZLE - MIDDLEWARES $middleware = function ($handler) { return function ($request, $options) use ($handler) { // Do before return $handler($request, $options) ->then(function () { // Do after }); }; }

Slide 40

Slide 40 text

GUZZLEHTTP/GUZZLE - MIDDLEWARES $middleware = GuzzleHttp\Middleware::log( $psrLogger, new GuzzleHttp\MessageFormatter() );

Slide 41

Slide 41 text

GUZZLEHTTP/GUZZLE - MIDDLEWARES Demo https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/4-middleware

Slide 42

Slide 42 text

GUZZLEHTTP/GUZZLE - WHAT ELSE What else?

Slide 43

Slide 43 text

GUZZLEHTTP/GUZZLE - PROGRESS $request->getEmitter()->on( 'progress', function (ProgressEvent $event) { … } );

Slide 44

Slide 44 text

GUZZLEHTTP/GUZZLE - PROGRESS Is gone! (>=5.0.0, <6.0.0)

Slide 45

Slide 45 text

GUZZLEHTTP/GUZZLE - PROGRESS No progress on promise? Too bad!

Slide 46

Slide 46 text

GUZZLEHTTP/GUZZLE - PROGRESS use Symfony\Component\Console \Helper\ProgressBar;

Slide 47

Slide 47 text

GUZZLEHTTP/GUZZLE - PROGRESS 10104/455642 [======>---------------------] 22% 14 sec/59 sec 1.4 MB

Slide 48

Slide 48 text

GUZZLEHTTP/GUZZLE - PROGRESS 15214/455642 [=========>------------------] 33% 21 sec/58 sec 2.1 MB

Slide 49

Slide 49 text

GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [============>---------------] 43% 28 sec/59 sec 3.0 MB

Slide 50

Slide 50 text

GUZZLEHTTP/GUZZLE - PROGRESS Roll your own

Slide 51

Slide 51 text

GUZZLEHTTP/GUZZLE - PROGRESS $response = $client->get($uri); // Psr\Http\Message\StreamInterface $stream = $response->getBody(); $stream->getSize(); $stream->eof(); $stream->read(1024);

Slide 52

Slide 52 text

3. php-http/adapter

Slide 53

Slide 53 text

PHP-HTTP/ADAPTER Imagine you’re writing an SDK for GitHub/Slack/Hipchat/DO/…

Slide 54

Slide 54 text

PHP-HTTP/ADAPTER composer require guzzlehttp/guzzle

Slide 55

Slide 55 text

No content

Slide 56

Slide 56 text

PHP-HTTP/ADAPTER - :CRY: “I already use Zend’s HTTP client! ”

Slide 57

Slide 57 text

PHP-HTTP/ADAPTER - :CRY: “I can’t install Guzzle v5 ánd v6! ”

Slide 58

Slide 58 text

PHP-HTTP/ADAPTER - SOLUTION Decouple from the HTTP client

Slide 59

Slide 59 text

No content

Slide 60

Slide 60 text

PHP-HTTP/ADAPTER - SOLUTION $adapter = new Adapter($guzzleClient); $psrRes = $adapter->sendRequest($psrReq); $client = new Client($adapter); $psrRes = $client->get($url);

Slide 61

Slide 61 text

PHP-HTTP/ADAPTER - SOLUTION public function __construct( Http\Adapter\HttpAdapter $adapter ) { $this->adapter = $adapter; } public function __construct( Http\Client\HttpClient $client ) { $this->client = $client; }

Slide 62

Slide 62 text

PHP-HTTP/ADAPTER - SOLUTION "require": { "php-http/adapter": "^0.1.0", "php-http/adapter-client": "^0.1.0",
 "php-http/adapter-implementation": "^0.1.0" }

Slide 63

Slide 63 text

PHP-HTTP/ADAPTER - SOLUTION Virtual package "provide": {
 "php-http/adapter-implementation": "^0.1.0" }

Slide 64

Slide 64 text

No content

Slide 65

Slide 65 text

PHP-HTTP/ADAPTER - ADAPTERS guzzle6-adapter guzzle5-adapter guzzle4-adapter guzzle3-adapter zend2-adapter zend1-adapter cake-adapter

Slide 66

Slide 66 text

PHP-HTTP/ADAPTER - ADAPTERS buzz-adapter react-adapter socket-adapter fopen-adapter file-get-contents-adapter native-curl-adapter pecl-adapter

Slide 67

Slide 67 text

PHP-HTTP/ADAPTER - COMPOSER.JSON "require": { "guzzlehttp/guzzle": "^5.0", "your-awesome/sdk": "^1.0",
 "php-http/guzzle5-adapter": "^0.1.0" }

Slide 68

Slide 68 text

PHP-HTTP/ADAPTER - COMPOSER.JSON "require": { - "guzzlehttp/guzzle": "^5.0", + "guzzlehttp/guzzle": "^6.0", "your-awesome/sdk": "^1.0",
 - "php-http/guzzle5-adapter": "^0.1.0" + "php-http/guzzle6-adapter": "^0.1.0" }

Slide 69

Slide 69 text

No content

Slide 70

Slide 70 text

PHP-HTTP/ADAPTER - DEMO Demo https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/5-github

Slide 71

Slide 71 text

RECAP 1. psr/http-message 2. guzzlehttp/guzzle 3. php-http/adapter

Slide 72

Slide 72 text

Time for questions. @hannesvdvreken

Slide 73

Slide 73 text

Thank you! @hannesvdvreken

Slide 74

Slide 74 text

• http:/ /mwl.be • https:/ /github.com/guzzle/guzzle • https:/ /github.com/php-http • http:/ /docs.guzzlephp.org/en/latest/ • https:/ /github.com/php-fig/http-message • https:/ /github.com/php-fig/fig-standards/
 blob/master/accepted/PSR-7-http-message.md REFERENCES