Skip to content

8.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 28 Aug 14:17
8.0.0
793b2f7

BREAKING CHANGE

  • Returns HTTP code 413 when post_max_size is exceeded #11708

    This case is not directly reported by PHP itself, neither via
    UploadedFileInterface, so we try our best to detect the situation and
    immediately returns the HTTP code 413. We do it immediately because when
    the case happens, PHP will leave $_POST entirely empty so we have no way
    to do anything further. So we let the client know via HTTP status and it
    is up to him to handle in the best way possible.

    When a 413 happens, the response body contains a detailed message
    similar to:

    {"message": "The server `post_max_size` is configured to accept 10.00 MiB, but received 28.00 MiB"}
  • UploadMiddleware::processRequest() is dropped entirely without replacement.
    If you need to use this library but you don't already use PSR-15 middleware,
    then you will have to implement a workaround yourself.

Added

  • Failed upload will throw the new UploadError #11708

    Previously it was up to the application to validate that the received
    UploadedFileInterface was $file->getError() === UPLOAD_ERR_OK. This
    is now included in UploadType and all UploadedFileInterface received
    by the application are guaranteed to be successful uploads.

Changed

  • Drop support for PHP 8.1