Zapytania i Odpowiedzi HTTP to podstawa aplikacji internetowych. Do tej pory każdy framework implementował je inaczej, jednak w maju 2015 roku PHP-FIG zatwierdziło PSR-7. Podczas prezentacji przedstawię zaproponowany interfejs pary Request/Response oraz postaram się odpowiedzieć na pytanie jakie korzyści może nam - programistom PHP - przynieść.

1. tekst
PSR-7 - HTTP message interfaces
Paweł Skotnicki

2. About me
PHP developer @ The Software House
PHPers Silesia co-organizer
BDD/DDD enthusiast

3. PHP-FIG ?

4. PHP Framework Interop
Group ?

5. PHP Standard
Recommendation ?

6. PSR ?

7. PHP-FIG
PHP Framework Interop Group
40+ members
PSR

8. PSR-0
Autoloading Standard

9. PSR-1
Basic Coding Standard

10. PSR-2
Coding Style Guide

11. PSR-3
Logger Interface

12. PSR-4
Autoloading Standard

13. PSR-5
PHPDoc Standard
(Draft)

14. PSR-6
Caching Interface
(Review)

15. PSR-7
HTTP message interfaces

16. HTTP request
POST /path HTTP/1.1
Host: example.com
foo=bar&baz=bat

17. HTTP response
HTTP/1.1 200 OK
Content-Type: text/plain
This is the response body

18. PSR-7
http://www.php-fig.org/psr/psr-7/
https://github.com/php-fig/http-message
composer require psr/http-message
namespace PsrHttpMessage

19. PsrHttpMessage
MessageInterface
ResponseInterface
RequestInterface
ServerRequestInterface
UriInterface
StreamInterface
UploadedFileInterface

20. MessageInterface
immutable value objects
protocol version
headers
body

21. HTTP Message Headers
$message->getHeader('Accept'); //array
$message->getHeaderLine('Accept'); //string
$message->hasHeader('Accept'); //boolean
/*
['Header’ => ['value1', 'value2']]
*/
$message->getHeaders();

22. HTTP Message Headers
$message = $message->withHeader('X-Foo', 'bar');
$message = $message->withAddedHeader(
'X-Foo',
'baz'
);
$message = $message->withoutHeader('X-Foo');

23. HTTP Message Body
StreamInterface
may be mutable !

24. ResponseInterface
$response->getStatusCode();
$response->getReasonPhrase();
$response = $response->withStatus(200, 'OK');

25. RequestInterface
method
request-target
uri
UriInterface

26. request-target
origin-form
absolute-form
authority-form
asterisk-form

27. RequestInterface
<get/with>Method
<get/with>RequestTarget
<get/with>Uri

28. ServerRequestInterface
getServerParams ($_SERVER)
<get/with>CookieParams ($_COOKIE)
<get/with>QueryParams ($_GET)
<get/with>UploadedFiles ($_FILES)
<get/with>ParsedBody ($_POST)
attributes

29. Uploaded Files
UploadedFileInterface
getStream() // StreamInterface
moveTo()
size, error, client filename, client media type
getUploadedFiles() - normalized structure

30. Single file upload
<input type="file" name="avatar" />

31. $_FILES
[
'avatar' => [
'tmp_name' => 'phpUxcOty',
'name' => 'my-avatar.png',
'size' => 90996,
'type' => 'image/png',
'error' => 0,
],
]

32. getUploadedFiles()
[
'avatar' => /* UploadedFileInterface instance */
]

33. Multiple files upload
<input type="file" "name="my-form[avatars][]" />
<input type="file" "name="my-form[avatars][]" />

34. $_FILES
[
'my-form' => [
'avatars' => [
'tmp_name' => [
0 => '...',
1 => '...',
],
'name' => […],
'size' => […],
'type' => […],
'error' => […],
],
],
]

35. getUploadedFiles()
[
'my-form' => [
'avatars' => [
0 => /* UploadedFileInterface instance */,
1 => /* UploadedFileInterface instance */,
],
],
]

36. Use cases
Clients
unified request and response interfaces
Middleware
Frameworks

38. Who ?
Guzzle, PHP HTTP client
Zend Diactoros, PSR HTTP Message implementation
PSR HTTP Message Bridge (Symfony 2)
Relay, PSR-7 middleware dispatcher
Aura Router

39. Questions?

40. Thank you