allow vendord
All checks were successful
Build, Push and Deploy / build-and-push (push) Successful in 3m3s
Gitea Actions Demo / Explore-Gitea-Actions (push) Successful in 16s
Build, Push and Deploy / deploy-staging (push) Successful in 32s
Build, Push and Deploy / deploy-production (push) Has been skipped
Build, Push and Deploy / cleanup (push) Successful in 1s

This commit is contained in:
2026-03-30 14:54:57 +07:00
parent 66aed7c4e8
commit b5e3a778ce
21316 changed files with 2777892 additions and 13 deletions

View File

@@ -0,0 +1,263 @@
<?php
namespace Aws\Exception;
use Aws\Api\Shape;
use Aws\CommandInterface;
use Aws\HasDataTrait;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
use Aws\ResponseContainerInterface;
use Aws\ResultInterface;
use JmesPath\Env as JmesPath;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\RequestInterface;
use Throwable;
/**
* Represents an AWS exception that is thrown when a command fails.
*/
class AwsException extends \RuntimeException implements
MonitoringEventsInterface,
ResponseContainerInterface,
\ArrayAccess
{
use HasDataTrait;
use HasMonitoringEventsTrait;
/** @var ResponseInterface */
private $response;
private $request;
private $result;
private $command;
private $requestId;
private $errorType;
private $errorCode;
private $errorShape;
private $connectionError;
private $transferInfo;
private $errorMessage;
private $maxRetriesExceeded;
/**
* @param string $message Exception message
* @param CommandInterface $command
* @param array $context Exception context
* @param Throwable|null $previous Previous exception (if any)
*/
public function __construct(
$message,
CommandInterface $command,
array $context = [],
?Throwable $previous = null
) {
$this->data = $context['body'] ?? [];
$this->command = $command;
$this->response = $context['response'] ?? null;
$this->request = $context['request'] ?? null;
$this->requestId = $context['request_id'] ?? null;
$this->errorType = $context['type'] ?? null;
$this->errorCode = $context['code'] ?? null;
$this->errorShape = $context['error_shape'] ?? null;
$this->connectionError = !empty($context['connection_error']);
$this->result = $context['result'] ?? null;
$this->transferInfo = $context['transfer_stats'] ?? [];
$this->errorMessage = $context['message'] ?? null;
$this->monitoringEvents = [];
$this->maxRetriesExceeded = false;
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 the AWS error shape.
*
* @return Shape|null Returns null if no response was received
*/
public function getAwsErrorShape()
{
return $this->errorShape;
}
/**
* 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 $this->transferInfo[$name] ?? null;
}
/**
* Replace the transfer information associated with an exception.
*
* @param array $info
*/
public function setTransferInfo(array $info)
{
$this->transferInfo = $info;
}
/**
* Returns whether the max number of retries is exceeded.
*
* @return bool
*/
public function isMaxRetriesExceeded()
{
return $this->maxRetriesExceeded;
}
/**
* Sets the flag for max number of retries exceeded.
*/
public function setMaxRetriesExceeded()
{
$this->maxRetriesExceeded = true;
}
public function hasKey($name)
{
return isset($this->data[$name]);
}
public function get($key)
{
return $this[$key];
}
public function search($expression)
{
return JmesPath::search($expression, $this->toArray());
}
}

View File

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

View File

@@ -0,0 +1,25 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class CouldNotCreateChecksumException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
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);
}
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class CredentialsException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
/**
* This class represents exceptions related to logic surrounding client-side
* encryption usage.
*/
class CryptoException extends \RuntimeException
{
}

View File

@@ -0,0 +1,10 @@
<?php
namespace Aws\Exception;
/**
* Class CryptoPolyfillException
*/
class CryptoPolyfillException extends \RuntimeException
{
}

View File

@@ -0,0 +1,38 @@
<?php
namespace Aws\Exception;
/**
* Represents an exception that was supplied via an EventStream.
*/
class EventStreamDataException extends \RuntimeException
{
private $errorCode;
private $errorMessage;
public function __construct($code, $message)
{
$this->errorCode = $code;
$this->errorMessage = $message;
parent::__construct($message);
}
/**
* Get the AWS error code.
*
* @return string|null Returns null if no response was received
*/
public function getAwsErrorCode()
{
return $this->errorCode;
}
/**
* Get the concise error message if any.
*
* @return string|null
*/
public function getAwsErrorMessage()
{
return $this->errorMessage;
}
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class IncalculablePayloadException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class InvalidJsonException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class InvalidRegionException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
}

View File

@@ -0,0 +1,63 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
use Aws\Multipart\UploadState;
class MultipartUploadException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
/** @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;
}
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class TokenException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class UnresolvedApiException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class UnresolvedEndpointException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
}

View File

@@ -0,0 +1,11 @@
<?php
namespace Aws\Exception;
use Aws\HasMonitoringEventsTrait;
use Aws\MonitoringEventsInterface;
class UnresolvedSignatureException extends \RuntimeException implements
MonitoringEventsInterface
{
use HasMonitoringEventsTrait;
}