The document discusses PSR-7, which defines HTTP message interfaces in PHP, including the Request and Response interfaces and their methods for handling HTTP messages. It outlines various aspects such as message headers, body handling through stream interfaces, and file uploads, providing specific examples like handling input files. Additionally, it mentions use cases and implementations for frameworks and libraries that utilize PSR-7 standards.

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