As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Tratamento de erros na AWS SDK para PHP versão 3
Tratamento de erros síncronos
Se ocorrer um erro durante a execução de uma operação, será gerada uma exceção. Por esse motivo, se você precisar tratar de erros em seu código, use blocos try
/catch
em torno de suas operações. O SDK gera exceções específicas ao serviço quando ocorre um erro.
O exemplo a seguir usa a Aws\S3\S3Client
. Se houver um erro, a exceção gerada será do tipo Aws\S3\Exception\S3Exception
. Todas as exceções específicas ao serviço que o SDK gera são estendidas da classe Aws\Exception\AwsException
. Essa classe contém informações úteis sobre a falha, incluindo o ID da solicitação, o código do erro e o tipo do erro. Observe que, para alguns serviços que oferecem suporte a ele, os dados de resposta são impelidos para uma estrutura de matriz associativa (semelhante a objetos Aws\Result
), que pode ser acessada como uma matriz PHP associativa normal. O método toArray()
retornará quaisquer dados, se eles existirem.
Importações
require 'vendor/autoload.php'; use Aws\S3\S3Client; use Aws\Exception\AwsException; use Aws\S3\Exception\S3Exception;
Código de exemplo
// Create an SDK class used to share configuration across clients. $sdk = new Aws\Sdk([ 'region' => 'us-west-2' ]); // Use an Aws\Sdk class to create the S3Client object. $s3Client = $sdk->createS3(); try { $s3Client->createBucket(['Bucket' => 'my-bucket']); } catch (S3Exception $e) { // Catch an S3 specific exception. echo $e->getMessage(); } catch (AwsException $e) { // This catches the more generic AwsException. You can grab information // from the exception using methods of the exception object. echo $e->getAwsRequestId() . "\n"; echo $e->getAwsErrorType() . "\n"; echo $e->getAwsErrorCode() . "\n"; // This dumps any modeled response data, if supported by the service // Specific members can be accessed directly (e.g. $e['MemberName']) var_dump($e->toArray()); }
Tratamento de erros assíncronos
As exceções não são geradas ao enviar solicitações assíncronas. Em vez disso, você deve usar o método then()
ou otherwise()
da promessa retornada para receber o resultado ou o erro.
Importações
require 'vendor/autoload.php'; use Aws\S3\S3Client; use Aws\Exception\AwsException; use Aws\S3\Exception\S3Exception;
Código de exemplo
//Asynchronous Error Handling $promise = $s3Client->createBucketAsync(['Bucket' => 'my-bucket']); $promise->otherwise(function ($reason) { var_dump($reason); }); // This does the same thing as the "otherwise" function. $promise->then(null, function ($reason) { var_dump($reason); });
Você pode "decodificar" a promessa e fazer com que a exceção seja gerada.
Importações
require 'vendor/autoload.php'; use Aws\S3\S3Client; use Aws\Exception\AwsException; use Aws\S3\Exception\S3Exception;
Código de exemplo
$promise = $s3Client->createBucketAsync(['Bucket' => 'my-bucket']);
//throw exception try { $result = $promise->wait(); } catch (S3Exception $e) { echo $e->getMessage(); }