PHP-FIG : HTTP message interfaces PSR-7 accepted

0
4899

Already 25 votes in favour of the new PSR-7 : HTTP message interfaces, which makes the new PHP standard recommendation accepted according to the PHP-FIG rules. Matthew Weier O’Phinney summarized changes of PSR-7 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.
  • 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.

You can find here the HTTP message interface and the HTTP message meta document, while the PHP-FIG have not officially announced the new PSR, it’s already a great achievement that will help guarantee interoperability between PHP packages for describing HTTP messages.

NO COMMENTS

LEAVE A REPLY