Modern HTTP handling with PHP - Meetup PHP West-Vlaanderen (BE)

PSR-7 describes common interfaces for representing HTTP messages. HTTP messages are the foundation of web development. Web browsers and HTTP clients such as cURL create HTTP request messages that are sent to a web server, which provides an HTTP response message. Server-side code receives an HTTP request message, and returns an HTTP response message. Hannes Van De Vreken (madewithlove) will talk about the impact of PSR-7 on the way frameworks implement these messages, and give a few live examples.

Transcript

1. HTTP messages Modern way of dealing with HTTP in PHP @hannesvdvreken @phpwvl
2. Hi, my name is Hannes.
3. madewithlove.be
7. PSR-7
8. PSR-7 Common interfaces for HTTP messages
9. 1. psr/http-message 2. guzzlehttp/guzzle 3. More PSR-7 usages
10. 1. psr/http-message
11. Differences with Symfony objects: Interfaces, not concretions PSR/HTTP-MESSAGE
12. Differences with Symfony objects: Interfaces, not concretions Immutable PSR/HTTP-MESSAGE
13. $newRequest = $request ->withHeader($name, $value); var_dump($newRequest === $request); > false PSR/HTTP-MESSAGE
14. PSR/HTTP-MESSAGE Showtime
15. PSR/HTTP-MESSAGE guzzlehttp/psr7 zendframework/zend-diactoros
16. PSR/HTTP-MESSAGE What about Symfony Request/Response objects?
17. PSR/HTTP-MESSAGE symfony/psr-http-message-bridge uses: zendframework/zend-diactoros
18. PSR/HTTP-MESSAGE PSR-7 request/response object ⁷ ⁷ Symfony request/response object
19. 2. guzzlehttp/guzzle
20. GUZZLEHTTP/GUZZLE composer require guzzlehttp/guzzle
21. GUZZLEHTTP/GUZZLE major version 6
22. GUZZLEHTTP/GUZZLE composer.json ^6.1
23. GUZZLEHTTP/GUZZLE composer.lock 6.1.0
25. GUZZLEHTTP/GUZZLE What’s new?
26. GUZZLEHTTP/GUZZLE - WHAT’S NEW PSR-7
27. GUZZLEHTTP/GUZZLE - PSR-7 guzzlehttp/psr7
28. GUZZLEHTTP/GUZZLE - PSR-7 "provide": { "psr/http-message-implementation": "1.0" },
31. GUZZLEHTTP/GUZZLE - PSR-7 use GuzzleHttp\Psr7\Request; $psrRequest = new Request( 'GET', $uri, $headers, $body );
32. GUZZLEHTTP/GUZZLE - PSR-7 $client = new GuzzleHttp\Client(); $client->send($psrRequest);
33. GUZZLEHTTP/GUZZLE - PSR-7 "require": { "php": ">=5.6.0", "guzzlehttp/psr7": "^1.1", }
34. GUZZLEHTTP/GUZZLE - PSR-7 Demo https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/1-guzzle
35. GUZZLEHTTP/GUZZLE - WHAT’S NEW What else?
36. GUZZLEHTTP/GUZZLE - PROMISES Promises
37. GUZZLEHTTP/GUZZLE - PROMISES Not so new: (>=5.0.0) Promises
38. GUZZLEHTTP/GUZZLE - PROMISES "require": { "php": ">=5.6.0", "guzzlehttp/psr7": "^1.1", "guzzlehttp/promise": "^1.0" }
39. GUZZLEHTTP/GUZZLE - PROMISES $promise = $client->sendAsync($request); $promise->then(function ($response) { $response->getBody(); }); $promise->wait();
40. GUZZLEHTTP/GUZZLE - PROMISES Demo https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/2-promise https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/3-multi
41. GUZZLEHTTP/GUZZLE - WHAT’S NEW What else?
42. GUZZLEHTTP/GUZZLE - EVENTING Previously (<4.0.0) symfony/event-dispatcher Later (>=4.0.0, <6.0.0) GuzzleHttp\Event\EmitterInterface GuzzleHttp\Event\SubscriberInterface
43. GUZZLEHTTP/GUZZLE - MIDDLEWARES Now (>=6.0.0) Callable middlewares
44. GUZZLEHTTP/GUZZLE - MIDDLEWARES $middleware = function ($handler) { return function ($request, $options) use ($handler) { // Do before return $handler($request, $options) ->then(function () { // Do after }); }; }
45. GUZZLEHTTP/GUZZLE - MIDDLEWARES $stack = HandlerStack::create(); $client = new Client(['handler' => $stack]); $stack->push($middleware); $stack->unshift($middleware); $stack->remove($middleware);
46. GUZZLEHTTP/GUZZLE - MIDDLEWARES $middleware = GuzzleHttp\Middleware::log( $psrLogger, new GuzzleHttp\MessageFormatter() );
47. GUZZLEHTTP/GUZZLE - MIDDLEWARES Demo https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/4-middleware
48. GUZZLEHTTP/GUZZLE - WHAT ELSE What else?
49. GUZZLEHTTP/GUZZLE - PROGRESS $request->getEmitter()->on( 'progress', function (ProgressEvent $event) { … } );
50. GUZZLEHTTP/GUZZLE - PROGRESS Is gone! (>=5.0.0, <6.0.0)
51. GUZZLEHTTP/GUZZLE - PROGRESS No progress on promise? Too bad!
52. GUZZLEHTTP/GUZZLE - PROGRESS Roll your own
53. GUZZLEHTTP/GUZZLE - PROGRESS // Psr\Http\Message\StreamInterface $stream = $response->getBody(); $stream->getSize(); $stream->eof(); $stream->read(1024);
54. GUZZLEHTTP/GUZZLE - PROGRESS use Symfony\Component\Console \Helper\ProgressBar;
55. GUZZLEHTTP/GUZZLE - PROGRESS 10104/455642 [======>---------------------] 22% 14 sec/59 sec 2.4 MB
56. GUZZLEHTTP/GUZZLE - PROGRESS 15214/455642 [=========>------------------] 33% 21 sec/58 sec 2.6 MB
57. GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [============>---------------] 43% 28 sec/59 sec 2.7 MB
58. GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [===============>------------] 53% 35 sec/58 sec 2.7 MB
59. GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [==================>---------] 59% 39 sec/58 sec 3.0 MB
60. GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [==================>---------] 59% 39 sec/58 sec 3.0 MB
61. GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [==================>---------] 59% 39 sec/58 sec 3.0 MB
62. GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [==================>---------] 59% 39 sec/58 sec 3.0 MB
63. GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [==================>---------] 59% 39 sec/58 sec 3.0 MB
64. GUZZLEHTTP/GUZZLE - PROGRESS 20325/455642 [==================>---------] 59% 39 sec/58 sec 3.0 MB
65. GUZZLEHTTP/GUZZLE - RECAP Uses PSR-7 interfaces Middlewares instead of Events Async & Promises
66. 3. More PSR-7 usages
67. Interface for PSR-7 HTTP Clients
68. PHP-HTTP/HTTPLUG Imagine you’re writing an SDK for GitHub/Slack/Hipchat/DO/…
69. PHP-HTTP/HTTPLUG composer require guzzlehttp/guzzle
71. PHP-HTTP/HTTPLUG - :CRY: “I already use Zend’s HTTP client! ”
72. PHP-HTTP/HTTPLUG - :CRY: “I can’t install Guzzle v5 ánd v6! ”
73. PHP-HTTP/HTTPLUG - SOLUTION Decouple from the HTTP client
75. PHP-HTTP/HTTPLUG - SOLUTION interface HttpPsrClient { public function sendRequest($request); public function sendRequests(array $requests); }
76. PHP-HTTP/HTTPLUG - SOLUTION Virtual package "provide": {
 "php-http/psr-client-implementation": "^0.1. }
77. PHP-HTTP/HTTPLUG - ADAPTERS guzzle6-adapter guzzle5-adapter guzzle4-adapter guzzle3-adapter zend2-adapter zend1-adapter cake-adapter
78. PHP-HTTP/HTTPLUG - ADAPTERS buzz-adapter react-adapter socket-adapter fopen-adapter file-get-contents-adapter native-curl-adapter pecl-adapter
79. PHP-HTTP/HTTPLUG - COMPOSER.JSON "require": { "guzzlehttp/guzzle": "^5.0", "your-awesome/sdk": "^1.0",
 "php-http/guzzle5-adapter": "^0.1.0" }
80. 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" }
82. PHP-HTTP/ADAPTER - DEMO Demo https:/ /github.com/hannesvdvreken/psr7-demo/tree/master/5-github
83. Middlewares wrapping HTTP applications
85. MIDDLEWARE DEFINITION function ( RequestInterface $request, ResponseInterface $response, callable $next ) {…};
86. MIDDLEWARE DEFINITION function (…) { // Before … $response = $next($request, $response); // After … return $response; }
87. MIDDLEWARE DEFINITION Session Logging Authentication Robots.txt file HTTP Cache Firewall Cors Throttling
88. MIGRATION FROM STACKPHP What about StackPHP (Symfony HTTP Kernel)?
89. MIGRATION FROM STACKPHP h4cc/stack-psr7-bridge uses: symfony/psr-http-message-bridge
90. MIGRATION FROM STACKPHP stack middleware ⁷ psr-7 middleware
91. RECAP HTTP client interface Middleware definition + upgrade path
92. RECAP 1. psr/http-message 2. guzzlehttp/guzzle 3. More PSR-7 usages
93. Time for questions. @hannesvdvreken @phpwvl
94. Thank you! @hannesvdvreken @phpwvl
95. • 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