[9.x] Add S3 temporaryUploadUrl method to AwsS3V3Adapter (#45753)

* Add temporaryUploadUrl methdo to AwsS3V3Adapter

* Add temporaryUploadUrl() to FilesystemAdapter

* Update facade docblocks

* Added aws s3 temporaryUploadUrl requiredHeaders option

* Update facade docblocks

* formatting

---------

Co-authored-by: aneeskhan47 <[email protected]>
Co-authored-by: Taylor Otwell <[email protected]>

Author: aneeskhan47

src/Illuminate/Filesystem/AwsS3V3Adapter.php

@@ -95,6 +95,40 @@ public function temporaryUrl($path, $expiration, array $options = [])
         return (string) $uri;
     }
 
+    /**
+     * Get a temporary upload URL for the file at the given path.
+     *
+     * @param  string  $path
+     * @param  \DateTimeInterface  $expiration
+     * @param  array  $options
+     * @return array
+     */
+    public function temporaryUploadUrl($path, $expiration, array $options = [])
+    {
+        $command = $this->client->getCommand('PutObject', array_merge([
+            'Bucket' => $this->config['bucket'],
+            'Key' => $this->prefixer->prefixPath($path),
+        ], $options));
+
+        $signedRequest = $this->client->createPresignedRequest(
+            $command, $expiration, $options
+        );
+
+        $uri = $signedRequest->getUri();
+
+        // If an explicit base URL has been set on the disk configuration then we will use
+        // it as the base URL instead of the default path. This allows the developer to
+        // have full control over the base path for this filesystem's generated URLs.
+        if (isset($this->config['temporary_url'])) {
+            $uri = $this->replaceBaseUrl($uri, $this->config['temporary_url']);
+        }
+
+        return [
+            'url' => (string) $uri,
+            'headers' => $signedRequest->getHeaders(),
+        ];
+    }
+
     /**
      * Get the underlying S3 client.
      *

src/Illuminate/Filesystem/FilesystemAdapter.php

@@ -733,6 +733,25 @@ public function temporaryUrl($path, $expiration, array $options = [])
         throw new RuntimeException('This driver does not support creating temporary URLs.');
     }
 
+    /**
+     * Get a temporary upload URL for the file at the given path.
+     *
+     * @param  string  $path
+     * @param  \DateTimeInterface  $expiration
+     * @param  array  $options
+     * @return array
+     *
+     * @throws \RuntimeException
+     */
+    public function temporaryUploadUrl($path, $expiration, array $options = [])
+    {
+        if (method_exists($this->adapter, 'temporaryUploadUrl')) {
+            return $this->adapter->temporaryUploadUrl($path, $expiration, $options);
+        }
+
+        throw new RuntimeException('This driver does not support creating temporary upload URLs.');
+    }
+
     /**
      * Concatenate a path to a URL.
      *

src/Illuminate/Support/Facades/Storage.php

@@ -59,6 +59,7 @@
  * @method static string url(string $path)
  * @method static bool providesTemporaryUrls()
  * @method static string temporaryUrl(string $path, \DateTimeInterface $expiration, array $options = [])
+ * @method static array temporaryUploadUrl(string $path, \DateTimeInterface $expiration, array $options = [])
  * @method static \League\Flysystem\FilesystemOperator getDriver()
  * @method static \League\Flysystem\FilesystemAdapter getAdapter()
  * @method static array getConfig()