Slide 1

Slide 1 text

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

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

PSR-7

Slide 6

Slide 6 text

PSR-7 Common interfaces for HTTP messages

Slide 7

Slide 7 text

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

Slide 8

Slide 8 text

1. psr/http-message

Slide 9

Slide 9 text

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

Slide 10

Slide 10 text

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

Slide 11

Slide 11 text

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

Slide 12

Slide 12 text

PSR/HTTP-MESSAGE Showtime

Slide 13

Slide 13 text

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

Slide 14

Slide 14 text

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

Slide 15

Slide 15 text

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

Slide 16

Slide 16 text

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

Slide 17

Slide 17 text

2. guzzlehttp/guzzle

Slide 18

Slide 18 text

GUZZLEHTTP/GUZZLE composer require guzzlehttp/guzzle

Slide 19

Slide 19 text

GUZZLEHTTP/GUZZLE major version 6

Slide 20

Slide 20 text

GUZZLEHTTP/GUZZLE composer.json ^6.1

Slide 21

Slide 21 text

GUZZLEHTTP/GUZZLE composer.lock 6.1.0

Slide 22

Slide 22 text

No content

Slide 23

Slide 23 text

GUZZLEHTTP/GUZZLE What’s new?

Slide 24

Slide 24 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW PSR-7

Slide 25

Slide 25 text

GUZZLEHTTP/GUZZLE - PSR-7 guzzlehttp/psr7

Slide 26

Slide 26 text

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

Slide 27

Slide 27 text

No content

Slide 28

Slide 28 text

No content

Slide 29

Slide 29 text

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

Slide 30

Slide 30 text

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

Slide 31

Slide 31 text

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

Slide 32

Slide 32 text

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

Slide 33

Slide 33 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW What else?

Slide 34

Slide 34 text

GUZZLEHTTP/GUZZLE - PROMISES Promises

Slide 35

Slide 35 text

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

Slide 36

Slide 36 text

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

Slide 37

Slide 37 text

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

Slide 38

Slide 38 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 39

Slide 39 text

GUZZLEHTTP/GUZZLE - WHAT’S NEW What else?

Slide 40

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

Slide 41 text

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

Slide 42

Slide 42 text

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

Slide 43

Slide 43 text

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

Slide 44

Slide 44 text

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

Slide 45

Slide 45 text

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

Slide 46

Slide 46 text

GUZZLEHTTP/GUZZLE - WHAT ELSE What else?

Slide 47

Slide 47 text

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

Slide 48

Slide 48 text

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

Slide 49

Slide 49 text

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

Slide 50

Slide 50 text

GUZZLEHTTP/GUZZLE - PROGRESS Roll your own

Slide 51

Slide 51 text

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

Slide 52

Slide 52 text

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

Slide 53

Slide 53 text

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

Slide 54

Slide 54 text

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

Slide 55

Slide 55 text

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

Slide 56

Slide 56 text

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

Slide 57

Slide 57 text

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

Slide 58

Slide 58 text

GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [==================>---------] 59% 39 sec/58 sec 3.0 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 - RECAP Uses PSR-7 interfaces Middlewares instead of Events Async & Promises

Slide 64

Slide 64 text

3. More PSR-7 usages

Slide 65

Slide 65 text

Interface for PSR-7 HTTP Clients

Slide 66

Slide 66 text

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

Slide 67

Slide 67 text

PHP-HTTP/HTTPLUG composer require guzzlehttp/guzzle

Slide 68

Slide 68 text

No content

Slide 69

Slide 69 text

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

Slide 70

Slide 70 text

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

Slide 71

Slide 71 text

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

Slide 72

Slide 72 text

No content

Slide 73

Slide 73 text

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

Slide 74

Slide 74 text

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

Slide 75

Slide 75 text

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

Slide 76

Slide 76 text

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

Slide 77

Slide 77 text

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

Slide 78

Slide 78 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 79

Slide 79 text

PHP-HTTP/HTTPLUG - COMPOSER.JSON $github = new Github\Client( // SDK new Http\Adapter\Guzzle6HttpAdapter( new GuzzleHttp\Client() ) );

Slide 80

Slide 80 text

No content

Slide 81

Slide 81 text

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

Slide 82

Slide 82 text

ADAPTERS - HTTP - Logging - File system

Slide 83

Slide 83 text

ADAPTERS Sadly not for caching

Slide 84

Slide 84 text

ADAPTERS psr/cache PSR-6 being voted on

Slide 85

Slide 85 text

Middlewares wrapping HTTP applications

Slide 86

Slide 86 text

No content

Slide 87

Slide 87 text

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

Slide 88

Slide 88 text

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

Slide 89

Slide 89 text

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

Slide 90

Slide 90 text

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

Slide 91

Slide 91 text

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

Slide 92

Slide 92 text

MIGRATION FROM STACKPHP stack middleware ⁷ psr-7 middleware

Slide 93

Slide 93 text

RECAP HTTP client interface Middleware definition + upgrade path

Slide 94

Slide 94 text

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

Slide 95

Slide 95 text

Time for questions. @hannesvdvreken @phplimbe

Slide 96

Slide 96 text

Thank you! @hannesvdvreken @phplimbe

Slide 97

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