Modern HTTP handling with PHP - Coolblue Behind The Scenes

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.

Transcript

1. HTTP messages Modern way of dealing with HTTP in PHP @hannesvdvreken @coolblue_nl
2. Hi, my name is Hannes.
3. !
4. madewithlove.be
5. #run010run
7. PSR-7 Common interfaces for HTTP messages
9. 1. psr/http-message 2. Server side 3. Client side
10. 1. psr/http-message
11. HTTP application PSR/HTTP-MESSAGE
12. PHP Script: $_SERVER - $_GET - $_POST - $_COOKIES - $_FILES PSR/HTTP-MESSAGE
13. Frameworks Zend, Symfony, Laravel, Silex, … PSR/HTTP-MESSAGE
14. composer require symfony/http-foundation composer require zendframework/zend-http PSR/HTTP-MESSAGE (RFC 7230 - 7231)
15. Example: Middleware that checks Authorization header from Request PSR/HTTP-MESSAGE
16. Example: Image library that generates a Response object for an image path PSR/HTTP-MESSAGE
17. Example: $response->send(); PSR/HTTP-MESSAGE
18. Example: RequestStack::class ExpressionRequestMatcher::class PSR/HTTP-MESSAGE
19. PSR/HTTP-MESSAGE PHP-FIG
20. Common interfaces for HTTP messages RFC PSR/HTTP-MESSAGE
21. Common interfaces for HTTP messages - Works in any Framework - Both for HTTP Clients and HTTP applications - HTTP version independent PSR/HTTP-MESSAGE
22. Common interfaces for HTTP messages RequestInterface ResponseInterface PSR/HTTP-MESSAGE
23. PSR/HTTP-MESSAGE May 2015: PSR-7 psr/http-message
24. Differences with Symfony HTTP foundation: Interfaced PSR/HTTP-MESSAGE
25. Differences with Symfony HTTP foundation: Interfaced Immutable PSR/HTTP-MESSAGE
26. $newRequest = $request ->withoutHeader($xHeader) ->withHeader($name, $value); var_dump($newRequest === $request); > false PSR/HTTP-MESSAGE
27. PSR/HTTP-MESSAGE let’s take a look
28. PSR/HTTP-MESSAGE interface RequestInterface { function getProtocolVersion(); function getHeaders(); function getHeader($name); function getHeaderLine($name); function getBody(); … } interface ResponseInterface { function getProtocolVersion(); function getHeaders(); function getHeader($name); function getHeaderLine($name); function getBody(); … }
29. PSR/HTTP-MESSAGE interface RequestInterface implements MessageInterface { function getRequestTarget(); function getUri(); function getMethod(); } interface ResponseInterface implements MessageInterface { function getStatusCode(); function getReasonPhrase(); }
30. PSR/HTTP-MESSAGE GET /madewithlove/blog HTTP/1.1 Host: api.github.com HTTP/1.1 200 OK
31. PSR/HTTP-MESSAGE $newRequest = $request ->withHeader($name, $value); ->withoutHeader(‘’); var_dump($newRequest === $request); > false
32. PSR/HTTP-MESSAGE - RECAP MessageInterface RequestInterface ResponseInterface StreamInterface❗ UriInterface ServerRequestInterface ($_GET, $_POST, $_SERVER, $_COOKIES, $_FILES)
33. PSR/HTTP-MESSAGE guzzlehttp/psr7 zendframework/zend-diactoros slim/slim
34. 2. Server side
35. START USING PSR-7 IN YOUR APP What about existing Symfony/Zend Request & Response objects?
36. START USING PSR-7 IN YOUR APP symfony/psr-http-message-bridge zendframework/zend-psr7bridge
37. START USING PSR-7 IN YOUR APP Symfony request/response object ⁷ ⁷ ⁷ Zend-Diactoros request/response object
38. START USING PSR-7 IN YOUR APP Symfony request/response object ⁷ ⁷ ⁷ Zend-Diactoros request/response object \Psr\Http\Message\RequestInterface type hinted
39. START USING PSR-7 IN YOUR APP Laravel: public function index(ServerRequestInterface $request){ return $psrResponse; }
40. START USING PSR-7 IN YOUR APP SlimPHP v3: routing & middleware
41. Middleware wrapping HTTP applications
43. MIDDLEWARE DEFINITION Session Logging Authentication Robots.txt file HTTP Cache Firewall Cors Throttling …
44. MIDDLEWARE DEFINITION function ( RequestInterface $request, ResponseInterface $response, callable $next ) {…};
45. MIDDLEWARE DEFINITION function ($request, $response, $next) { // Alter request, if you want $response = $next($request, $response); // Alter response, if you want return $response; }
46. MIDDLEWARE DEFINITION Build your stack with: relay/relay mindplay/middleman
47. Demo
48. HTTP MIDDLEWARE PSR-15 will change that
49. PSR-15 is not accepted yet HTTP MIDDLEWARE
50. https:/ /github.com/php-fig/fig-standards/ blob/master/proposed/http-middleware/ middleware.md HTTP MIDDLEWARE - PSR-15
51. MiddlewareInterface DelegateInterface HTTP MIDDLEWARE - PSR-15
52. interface MiddlewareInterface { public function process( ServerRequestInterface $request, DelegateInterface $delegate ); } HTTP MIDDLEWARE - PSR-15
53. HTTP MIDDLEWARE - PSR-15 interface DelegateInterface { public function process( ServerRequestInterface $request ); }
54. class CacheMiddleware implements MiddlewareInterface { public function process( ServerRequestInterface $request, DelegateInterface $delegate ) { // Alter request, if you want $response = $delegate->process($request); // Alter response, if you want return $response; } } HTTP MIDDLEWARE - PSR-15
55. Demo
56. 3. Client side
57. GUZZLEHTTP/GUZZLE composer req guzzlehttp/guzzle
58. GUZZLEHTTP/GUZZLE composer.json ^6.2
59. …
60. semver.mwl.be
61. GUZZLEHTTP/GUZZLE - WHAT’S NEW PSR-7
62. GUZZLEHTTP/GUZZLE - PSR-7 guzzlehttp/psr7
63. GUZZLEHTTP/GUZZLE - PSR-7 - COMPOSER.JSON "provide": { "psr/http-message-implementation": "1.0" },
66. GUZZLEHTTP/GUZZLE - PSR-7 use GuzzleHttp\Psr7\Request; $psrRequest = new Request( 'GET', $uri, $headers, $body );
67. GUZZLEHTTP/GUZZLE - PSR-7 $client = new GuzzleHttp\Client(); $psrResponse = $client->send($psrRequest);
68. GUZZLEHTTP/GUZZLE Demo
69. GUZZLEHTTP/GUZZLE - PROMISES Promises
70. GUZZLEHTTP/GUZZLE - PSR-7 guzzlehttp/promise
71. GUZZLEHTTP/GUZZLE - PROMISES use Psr\Http\Message\ResponseInterface as Res; $promise = $client->sendAsync($request); $promise->then(function (Res $response) { $response->getBody(); }); $promise->wait();
72. GUZZLEHTTP/GUZZLE Demo
73. GUZZLEHTTP/GUZZLE - MIDDLEWARES Callable middlewares
74. GUZZLEHTTP/GUZZLE - MIDDLEWARES $middleware = function ($handler) { return function ($request, $options) use ($handler) { // Alter request, if you want return $handler($request, $options) ->then(function (ResponseInterface $response) { // Alter response, if you want return $response; }); }; }
75. GUZZLEHTTP/GUZZLE - MIDDLEWARES $middleware = GuzzleHttp\Middleware::log( $psr3Logger, new GuzzleHttp\MessageFormatter() );
76. GUZZLEHTTP/GUZZLE - MIDDLEWARES $stack = HandlerStack::create(); $stack->push($middleware); $stack->unshift($middleware); $stack->remove($middleware); $client = new Client(['handler' => $stack]);
77. GUZZLEHTTP/GUZZLE - MIDDLEWARES Demo
78. Decoupling HTTP Clients
79. PHP-HTTP/HTTPLUG - SOLUTION php-http/httplug
80. PHP-HTTP/HTTPLUG - SOLUTION interface HttpClient { public function sendRequest($request); } interface HttpAsyncClient { public function sendAsyncRequest($request); }
81. PHP-HTTP/HTTPLUG - SOLUTION Virtual package "provide": {
 "php-http/client-implementation": "^0.1.0", }
82. PHP-HTTP/HTTPLUG - SOLUTION $guzzle = new GuzzleHttp\Client(); $adapter = new Http\Adapter\Guzzle5\Client($guzzle); $psrResponse = $adapter->sendRequest($psrRequest);
83. PHP-HTTP/HTTPLUG - ADAPTERS guzzle6-adapter guzzle5-adapter guzzle4-adapter guzzle3-adapter zend2-adapter zend1-adapter cake-adapter buzz-adapter react-adapter socket-client fopen-adapter file-get-contents-adapter curl-client mock-client
84. PHP-HTTP/HTTPLUG - COMPOSER.JSON "require": { "guzzlehttp/guzzle": "^5.0",
 "php-http/guzzle5-adapter": "^0.1.0" }
85. PHP-HTTP/HTTPLUG - COMPOSER.JSON "require": { - "guzzlehttp/guzzle": "^5.0", + "guzzlehttp/guzzle": "^6.0",
 - "php-http/guzzle5-adapter": "^0.1.0" + "php-http/guzzle6-adapter": "^0.1.0" }
87. RECAP 1. Guzzle PSR-7 2. Promises 3. Middleware 4. Client abstraction
88. RECAP 1. psr/http-message 2. Server side 3. Client side
89. Thank you! @hannesvdvreken @coolblue_nl
90. Time for questions. @hannesvdvreken @coolblue_nl
91. • 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