spaces.php

aws/Aws/Exception/AwsException.php

@@ -0,0 +1,208 @@
+<?php
+namespace Aws\Exception;
+
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\RequestInterface;
+use Aws\CommandInterface;
+use Aws\ResultInterface;
+
+/**
+ * Represents an AWS exception that is thrown when a command fails.
+ */
+class AwsException extends \RuntimeException
+{
+    /** @var ResponseInterface */
+    private $response;
+    private $request;
+    private $result;
+    private $command;
+    private $requestId;
+    private $errorType;
+    private $errorCode;
+    private $connectionError;
+    private $transferInfo;
+    private $errorMessage;
+
+    /**
+     * @param string           $message Exception message
+     * @param CommandInterface $command
+     * @param array            $context Exception context
+     * @param \Exception       $previous  Previous exception (if any)
+     */
+    public function __construct(
+        $message,
+        CommandInterface $command,
+        array $context = [],
+        \Exception $previous = null
+    ) {
+        $this->command = $command;
+        $this->response = isset($context['response']) ? $context['response'] : null;
+        $this->request = isset($context['request']) ? $context['request'] : null;
+        $this->requestId = isset($context['request_id'])
+            ? $context['request_id']
+            : null;
+        $this->errorType = isset($context['type']) ? $context['type'] : null;
+        $this->errorCode = isset($context['code']) ? $context['code'] : null;
+        $this->connectionError = !empty($context['connection_error']);
+        $this->result = isset($context['result']) ? $context['result'] : null;
+        $this->transferInfo = isset($context['transfer_stats'])
+            ? $context['transfer_stats']
+            : [];
+        $this->errorMessage = isset($context['message'])
+            ? $context['message']
+            : null;
+        parent::__construct($message, 0, $previous);
+    }
+
+    public function __toString()
+    {
+        if (!$this->getPrevious()) {
+            return parent::__toString();
+        }
+
+        // PHP strangely shows the innermost exception first before the outer
+        // exception message. It also has a default character limit for
+        // exception message strings such that the "next" exception (this one)
+        // might not even get shown, causing developers to attempt to catch
+        // the inner exception instead of the actual exception because they
+        // can't see the outer exception's __toString output.
+        return sprintf(
+            "exception '%s' with message '%s'\n\n%s",
+            get_class($this),
+            $this->getMessage(),
+            parent::__toString()
+        );
+    }
+
+    /**
+     * Get the command that was executed.
+     *
+     * @return CommandInterface
+     */
+    public function getCommand()
+    {
+        return $this->command;
+    }
+
+    /**
+     * Get the concise error message if any.
+     *
+     * @return string|null
+     */
+    public function getAwsErrorMessage()
+    {
+        return $this->errorMessage;
+    }
+
+    /**
+     * Get the sent HTTP request if any.
+     *
+     * @return RequestInterface|null
+     */
+    public function getRequest()
+    {
+        return $this->request;
+    }
+
+    /**
+     * Get the received HTTP response if any.
+     *
+     * @return ResponseInterface|null
+     */
+    public function getResponse()
+    {
+        return $this->response;
+    }
+
+    /**
+     * Get the result of the exception if available
+     *
+     * @return ResultInterface|null
+     */
+    public function getResult()
+    {
+        return $this->result;
+    }
+
+    /**
+     * Returns true if this is a connection error.
+     *
+     * @return bool
+     */
+    public function isConnectionError()
+    {
+        return $this->connectionError;
+    }
+
+    /**
+     * If available, gets the HTTP status code of the corresponding response
+     *
+     * @return int|null
+     */
+    public function getStatusCode()
+    {
+        return $this->response ? $this->response->getStatusCode() : null;
+    }
+
+    /**
+     * Get the request ID of the error. This value is only present if a
+     * response was received and is not present in the event of a networking
+     * error.
+     *
+     * @return string|null Returns null if no response was received
+     */
+    public function getAwsRequestId()
+    {
+        return $this->requestId;
+    }
+
+    /**
+     * Get the AWS error type.
+     *
+     * @return string|null Returns null if no response was received
+     */
+    public function getAwsErrorType()
+    {
+        return $this->errorType;
+    }
+
+    /**
+     * Get the AWS error code.
+     *
+     * @return string|null Returns null if no response was received
+     */
+    public function getAwsErrorCode()
+    {
+        return $this->errorCode;
+    }
+
+    /**
+     * Get all transfer information as an associative array if no $name
+     * argument is supplied, or gets a specific transfer statistic if
+     * a $name attribute is supplied (e.g., 'retries_attempted').
+     *
+     * @param string $name Name of the transfer stat to retrieve
+     *
+     * @return mixed|null|array
+     */
+    public function getTransferInfo($name = null)
+    {
+        if (!$name) {
+            return $this->transferInfo;
+        }
+
+        return isset($this->transferInfo[$name])
+            ? $this->transferInfo[$name]
+            : null;
+    }
+
+    /**
+     * Replace the transfer information associated with an exception.
+     *
+     * @param array $info
+     */
+    public function setTransferInfo(array $info)
+    {
+        $this->transferInfo = $info;
+    }
+}

aws/Aws/Exception/CouldNotCreateChecksumException.php

@@ -0,0 +1,19 @@
+<?php
+namespace Aws\Exception;
+
+class CouldNotCreateChecksumException extends \RuntimeException
+{
+    public function __construct($algorithm, \Exception $previous = null)
+    {
+        $prefix = $algorithm === 'md5' ? "An" : "A";
+        parent::__construct("{$prefix} {$algorithm} checksum could not be "
+            . "calculated for the provided upload body, because it was not "
+            . "seekable. To prevent this error you can either 1) include the "
+            . "ContentMD5 or ContentSHA256 parameters with your request, 2) "
+            . "use a seekable stream for the body, or 3) wrap the non-seekable "
+            . "stream in a GuzzleHttp\\Psr7\\CachingStream object. You "
+            . "should be careful though and remember that the CachingStream "
+            . "utilizes PHP temp streams. This means that the stream will be "
+            . "temporarily stored on the local disk.", 0, $previous);
+    }
+}

aws/Aws/Exception/CredentialsException.php

@@ -0,0 +1,4 @@
+<?php
+namespace Aws\Exception;
+
+class CredentialsException extends \RuntimeException {}

aws/Aws/Exception/MultipartUploadException.php

@@ -0,0 +1,58 @@
+<?php
+namespace Aws\Exception;
+
+use Aws\Multipart\UploadState;
+
+class MultipartUploadException extends \RuntimeException
+{
+    /** @var UploadState State of the erroneous transfer */
+    private $state;
+
+    /**
+     * @param UploadState      $state Upload state at time of the exception.
+     * @param \Exception|array $prev  Exception being thrown.
+     */
+    public function __construct(UploadState $state, $prev = null) {
+        $msg = 'An exception occurred while performing a multipart upload';
+
+        if (is_array($prev)) {
+            $msg = strtr($msg, ['performing' => 'uploading parts to']);
+            $msg .= ". The following parts had errors:\n";
+            /** @var $error AwsException */
+            foreach ($prev as $part => $error) {
+                $msg .= "- Part {$part}: " . $error->getMessage(). "\n";
+            }
+        } elseif ($prev instanceof AwsException) {
+            switch ($prev->getCommand()->getName()) {
+                case 'CreateMultipartUpload':
+                case 'InitiateMultipartUpload':
+                    $action = 'initiating';
+                    break;
+                case 'CompleteMultipartUpload':
+                    $action = 'completing';
+                    break;
+            }
+            if (isset($action)) {
+                $msg = strtr($msg, ['performing' => $action]);
+            }
+            $msg .= ": {$prev->getMessage()}";
+        }
+
+        if (!$prev instanceof \Exception) {
+            $prev = null;
+        }
+
+        parent::__construct($msg, 0, $prev);
+        $this->state = $state;
+    }
+
+    /**
+     * Get the state of the transfer
+     *
+     * @return UploadState
+     */
+    public function getState()
+    {
+        return $this->state;
+    }
+}

aws/Aws/Exception/UnresolvedApiException.php

@@ -0,0 +1,4 @@
+<?php
+namespace Aws\Exception;
+
+class UnresolvedApiException extends \RuntimeException {}

aws/Aws/Exception/UnresolvedEndpointException.php

@@ -0,0 +1,4 @@
+<?php
+namespace Aws\Exception;
+
+class UnresolvedEndpointException extends \RuntimeException {}

aws/Aws/Exception/UnresolvedSignatureException.php

@@ -0,0 +1,4 @@
+<?php
+namespace Aws\Exception;
+
+class UnresolvedSignatureException extends \RuntimeException {}