Slide 1

Slide 1 text

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

Slide 2

Slide 2 text

Hi, my name is Hannes.

Slide 3

Slide 3 text

madewithlove.be

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

No content

Slide 6

Slide 6 text

No content

Slide 7

Slide 7 text

PSR-7

Slide 8

Slide 8 text

PSR-7 Common interfaces for HTTP messages

Slide 9

Slide 9 text

1. psr/http-message 2. guzzlehttp/guzzle 3. More PSR-7 usages

Slide 10

Slide 10 text

1. psr/http-message

Slide 11

Slide 11 text

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

Slide 12

Slide 12 text

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

Slide 13

Slide 13 text

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

Slide 14

Slide 14 text

PSR/HTTP-MESSAGE Showtime

Slide 15

Slide 15 text

PSR/HTTP-MESSAGE guzzlehttp/psr7 zendframework/zend-diactoros

Slide 16

Slide 16 text

PSR/HTTP-MESSAGE What about Symfony Request/Response objects?

Slide 17

Slide 17 text

PSR/HTTP-MESSAGE symfony/psr-http-message-bridge uses: zendframework/zend-diactoros

Slide 18

Slide 18 text

PSR/HTTP-MESSAGE PSR-7 request/response object ⁷ ⁷ Symfony request/response object

Slide 19

Slide 19 text

2. guzzlehttp/guzzle

Slide 20

Slide 20 text

GUZZLEHTTP/GUZZLE composer require guzzlehttp/guzzle

Slide 21

Slide 21 text

GUZZLEHTTP/GUZZLE major version 6

Slide 22

Slide 22 text

GUZZLEHTTP/GUZZLE composer.json ^6.1

Slide 23

Slide 23 text

GUZZLEHTTP/GUZZLE composer.lock 6.1.0

Slide 24

Slide 24 text

No content

Slide 25

Slide 25 text

GUZZLEHTTP/GUZZLE What’s new?

Slide 26

Slide 26 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW PSR-7

Slide 27

Slide 27 text

GUZZLEHTTP/GUZZLE - PSR-7 guzzlehttp/psr7

Slide 28

Slide 28 text

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

Slide 29

Slide 29 text

No content

Slide 30

Slide 30 text

No content

Slide 31

Slide 31 text

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

Slide 32

Slide 32 text

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

Slide 33

Slide 33 text

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

Slide 34

Slide 34 text

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

Slide 35

Slide 35 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW What else?

Slide 36

Slide 36 text

GUZZLEHTTP/GUZZLE - PROMISES Promises

Slide 37

Slide 37 text

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

Slide 38

Slide 38 text

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

Slide 39

Slide 39 text

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

Slide 40

Slide 40 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 41

Slide 41 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW What else?

Slide 42

Slide 42 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 43

Slide 43 text

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

Slide 44

Slide 44 text

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

Slide 45

Slide 45 text

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

Slide 46

Slide 46 text

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

Slide 47

Slide 47 text

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

Slide 48

Slide 48 text

GUZZLEHTTP/GUZZLE - WHAT ELSE What else?

Slide 49

Slide 49 text

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

Slide 50

Slide 50 text

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

Slide 51

Slide 51 text

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

Slide 52

Slide 52 text

GUZZLEHTTP/GUZZLE - PROGRESS Roll your own

Slide 53

Slide 53 text

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

Slide 54

Slide 54 text

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

Slide 55

Slide 55 text

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

Slide 56

Slide 56 text

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

Slide 57

Slide 57 text

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

Slide 58

Slide 58 text

GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [===============>------------] 53% 35 sec/58 sec 2.7 MB

Slide 59

Slide 59 text

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

Slide 60

Slide 60 text

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

Slide 61

Slide 61 text

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

Slide 62

Slide 62 text

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

Slide 63

Slide 63 text

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

Slide 64

Slide 64 text

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

Slide 65

Slide 65 text

GUZZLEHTTP/GUZZLE - RECAP Uses PSR-7 interfaces Middlewares instead of Events Async & Promises

Slide 66

Slide 66 text

3. More PSR-7 usages

Slide 67

Slide 67 text

Interface for PSR-7 HTTP Clients

Slide 68

Slide 68 text

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

Slide 69

Slide 69 text

PHP-HTTP/HTTPLUG composer require guzzlehttp/guzzle

Slide 70

Slide 70 text

No content

Slide 71

Slide 71 text

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

Slide 72

Slide 72 text

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

Slide 73

Slide 73 text

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

Slide 74

Slide 74 text

No content

Slide 75

Slide 75 text

PHP-HTTP/HTTPLUG - SOLUTION interface HttpPsrClient { public function sendRequest($request); public function sendRequests(array $requests); }

Slide 76

Slide 76 text

PHP-HTTP/HTTPLUG - SOLUTION Virtual package "provide": {
 "php-http/psr-client-implementation": "^0.1. }

Slide 77

Slide 77 text

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

Slide 78

Slide 78 text

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

Slide 79

Slide 79 text

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

Slide 80

Slide 80 text

PHP-HTTP/HTTPLUG - 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 81

Slide 81 text

No content

Slide 82

Slide 82 text

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

Slide 83

Slide 83 text

Middlewares wrapping HTTP applications

Slide 84

Slide 84 text

No content

Slide 85

Slide 85 text

MIDDLEWARE DEFINITION function ( RequestInterface $request, ResponseInterface $response, callable $next ) {…};

Slide 86

Slide 86 text

MIDDLEWARE DEFINITION function (…) { // Before … $response = $next($request, $response); // After … return $response; }

Slide 87

Slide 87 text

MIDDLEWARE DEFINITION Session Logging Authentication Robots.txt file HTTP Cache Firewall Cors Throttling

Slide 88

Slide 88 text

MIGRATION FROM STACKPHP What about StackPHP (Symfony HTTP Kernel)?

Slide 89

Slide 89 text

MIGRATION FROM STACKPHP h4cc/stack-psr7-bridge uses: symfony/psr-http-message-bridge

Slide 90

Slide 90 text

MIGRATION FROM STACKPHP stack middleware ⁷ psr-7 middleware

Slide 91

Slide 91 text

RECAP HTTP client interface Middleware definition + upgrade path

Slide 92

Slide 92 text

RECAP 1. psr/http-message 2. guzzlehttp/guzzle 3. More PSR-7 usages

Slide 93

Slide 93 text

Time for questions. @hannesvdvreken @phpwvl

Slide 94

Slide 94 text

Thank you! @hannesvdvreken @phpwvl

Slide 95

Slide 95 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