From b5e220c2d0a12df1eb3d1c19344282f4c191b603 Mon Sep 17 00:00:00 2001 From: Dries Vints Date: Mon, 28 Feb 2022 09:55:24 +0100 Subject: [PATCH 1/2] Update upgrade.md --- upgrade.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/upgrade.md b/upgrade.md index 9ded856ed74..c1dbf64f62d 100644 --- a/upgrade.md +++ b/upgrade.md @@ -322,6 +322,10 @@ Before using the S3, FTP, or SFTP drivers, you will need to install the appropri Write operations such as `put`, `write`, `writeStream` now overwrite existing files by default. If you do not want to overwrite existing files, you should manually check for the file's existence before performing the write operation. +#### Exception Throwing + +Methods such as `put`, `write`, `writeStream` no longer throw a Flysystem exception and will return `false` when a write operation fails. This is because Flysystem now throws an non-specific `UnableToWriteFile` exception instead of the previous more specific `FileExistsException` exception. + #### Reading Missing Files Attempting to read from a file that does not exist now returns `null`. In previous releases of Laravel, an `Illuminate\Contracts\Filesystem\FileNotFoundException` would have been thrown. From 3c79dc5ed22ce05b448b3f84568b0b545109e09b Mon Sep 17 00:00:00 2001 From: Taylor Otwell Date: Mon, 28 Feb 2022 10:19:25 -0600 Subject: [PATCH 2/2] Update upgrade.md --- upgrade.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/upgrade.md b/upgrade.md index c1dbf64f62d..fe626211161 100644 --- a/upgrade.md +++ b/upgrade.md @@ -320,11 +320,11 @@ Before using the S3, FTP, or SFTP drivers, you will need to install the appropri #### Overwriting Existing Files -Write operations such as `put`, `write`, `writeStream` now overwrite existing files by default. If you do not want to overwrite existing files, you should manually check for the file's existence before performing the write operation. +Write operations such as `put`, `write`, and `writeStream` now overwrite existing files by default. If you do not want to overwrite existing files, you should manually check for the file's existence before performing the write operation. -#### Exception Throwing +#### Write Exceptions -Methods such as `put`, `write`, `writeStream` no longer throw a Flysystem exception and will return `false` when a write operation fails. This is because Flysystem now throws an non-specific `UnableToWriteFile` exception instead of the previous more specific `FileExistsException` exception. +Write operations such as `put`, `write`, and `writeStream` no longer throw an exception when a write operation fails. Instead, `false` is returned. #### Reading Missing Files