psr-7-packages

A talk about packages that use the common request/response interfaces of PSR-7. They showcase the force of interoperable interfaces.

Demo code for this talk can be found here: https://github.com/hannesvdvreken/psr7-demo

Presented at php.gent for the first time on June 30th 2015.

Transcript

1. Highlighted packages
   packagist’s finest selection of libraries
   

   View Slide

2. Hi, my name is Hannes.
   

   View Slide

3. madewithlove
   

   View Slide

4. MongoDB Belgium
   

   View Slide

5. View Slide

6. Highlighted packages
   

   View Slide

7. 1. guzzlehttp/guzzle
   2. php-http/adapter
   

   View Slide

8. 1. guzzlehttp/guzzle
   

   View Slide

9. GUZZLEHTTP/GUZZLE
   composer require guzzlehttp/guzzle
   

   View Slide

10. GUZZLEHTTP/GUZZLE
    ^6.0
    

    View Slide

11. GUZZLEHTTP/GUZZLE
    semver.mwl.be
    

    View Slide

12. View Slide

13. GUZZLEHTTP/GUZZLE
    What’s new?
    

    View Slide

14. GUZZLEHTTP/GUZZLE - WHAT’S NEW
    PSR-7
    

    View Slide

15. GUZZLEHTTP/GUZZLE - PSR-7
    Psr\Http\Message\RequestInterface
    Psr\Http\Message\ResponseInterface
    

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

19. GUZZLEHTTP/GUZZLE - PSR-7
    Differences with Symfony objects:
    Implementations for interfaces
    Immutable
    

    View Slide

20. GUZZLEHTTP/GUZZLE - PSR-7
    $newRequest = $request
    ->withHeader($name, $value);
    var_dump($newRequest === $request);
    > false
    

    View Slide

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

    View Slide

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

    View Slide

23. GUZZLEHTTP/GUZZLE - WHAT’S NEW
    What else?
    

    View Slide

24. GUZZLEHTTP/GUZZLE - PROMISES
    Promises
    

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

29. GUZZLEHTTP/GUZZLE - WHAT’S NEW
    What else?
    

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

36. GUZZLEHTTP/GUZZLE - WHAT ELSE
    What else?
    

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

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

    View Slide

44. GUZZLEHTTP/GUZZLE - PROGRESS
    Roll your own
    

    View Slide

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

    View Slide

46. 2. php-http/adapter
    

    View Slide

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

    View Slide

48. PHP-HTTP/ADAPTER
    composer require guzzlehttp/guzzle
    

    View Slide

49. View Slide

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

    View Slide

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

    View Slide

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

    View Slide

53. View Slide

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

    View Slide

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

    View Slide

56. 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"
    }
    

    View Slide

57. PHP-HTTP/ADAPTER - SOLUTION
    Virtual package
    "provide": {

    "php-http/adapter-implementation": "^0.1.0"
    }
    

    View Slide

58. View Slide

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

    View Slide

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

    View Slide

61. PHP-HTTP/ADAPTER - COMPOSER.JSON
    "require": {
    "guzzlehttp/guzzle": "^5.0",
    "your-awesome/sdk": "^1.0",

    "php-http/guzzle5-adapter": "^0.1.0"
    }
    

    View Slide

62. 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"
    }
    

    View Slide

63. View Slide

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

    View Slide

65. RECAP
    1. guzzlehttp/guzzle
    2. php-http/adapter
    

    View Slide

66. Questions?
    

    View Slide

67. Thank you!
    @hannesvdvreken
    

    View Slide

68. • 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
    

    View Slide