[10.x] Make $path optional in Filesystem methods

[innocenzi]

Follow-up of #44384, since this contains breaking changes to method signatures, this PR is targeted at master instead of 9.x.

---

This PR makes the $path parameter optional in the following methods:

• FilesystemAdapter#putFile
• FilesystemAdapter#putFileAs
• UploadedFile#store
• UploadedFile#storeAs
• UploadedFile#storePublicly
• UploadedFile#storePubliclyAs

Since #44105 (thanks Frank), I've been using the scoped driver in order to be able not to repeat paths throughout my codebases. It allows me to do the following:

// Before
Storage::disk('s3')->putFile('chat/attachments', $uploadedFile);
//                           ~~~~~~~~~~~~~~~~~~  This could be repeated in some places

// After
Storage::disk(Disk::ChatAttachments)->putFile('', $uploadedFile)

With this PR, it's possible to omit the first argument, so one could do this instead:

Storage::disk(Disk::ChatAttachments)->putFile($uploadedFile)

[ar2r]

It will be more usefull like this, but i dont need that:

Storage::disk('s3')->putFiles('chat/attachments', [$uploadedFile1,$uploadedFile2]);

Your code allows you to upload files without controlling the directory and the level of access to this file. the path can be defined in a constant and you can reuse it every time, instead of a string.

[innocenzi]

I'd rather the constant be the disk, that's why I do that. The path is defined in the disk definition, so, yes, I do control the directory.

[taylorotwell]

Just curious - why would the put method not allow this?

[innocenzi]

That's an omission. Added it 👍

[milwad-dev]

Good