Summary of PSR-7 changes since Review 2 began.

summary.md

Summary of changes since Review 2 Started

• Expanded section on expected structure returned by getUploadedFiles(), with several examples ranging from a flat structure to a nested structure with a collection of files.
• Clarifications and simplification of URI -> Host header interactions.
  • Updated withUri() to indicate it MUST update the Host header with the value present in the URI provided (if any) UNLESS the $preserveHost flag is boolean true.
  • Removed getHeader*() method overrides in RequestInterface, as they were no longer relevant with the above changes.
• MessageInterface::getHeaderLine()'s signature was altered to always return a string (the string will be empty if the value is not defined). This removes ambiguity in the return value.
• ResponseInterface::getReasonPhrase()'s signature was altered to always return a string (the string will be empty if the value is not defined). This removes ambiguity in the return value.
• ResponseInterface::withStatus()'s signature was altered to provide an empty string as the default value of the $reasonPhrase argument.
• UriInterface::withPath() clarifies that both relative and domain-relative paths (prefixed with /) may be set.
• UploadedFileInterface::move($path) was renamed to moveTo($targetPath) to clarify intent; additionally, $targetPath was clarified as being an absolute path or a relative path, with resolution following PHP's rules when rename() is called.