Usar o AWS SDK for PHP e executar exemplos do PHP - Amazon Simple Storage Service

Usar o AWS SDK for PHP e executar exemplos do PHP

O AWS SDK for PHP fornece acesso à API para operações de buckets e objetos do Amazon S3. O SDK fornece a opção de usar a API de baixo nível do serviço ou abstrações de alto nível.

O SDK está disponível no AWS SDK for PHP, que também tem instruções para instalar e começar a usar o SDK.

A configuração para usar o AWS SDK for PHP depende do ambiente e de como você deseja executar seu aplicativo. Para configurar o ambiente para executar os exemplos desta documentação, consulte o Guia de conceitos básicos do AWS SDK for PHP.

AWS SDK for PHPNíveis do

O AWS SDK for PHP oferece a opção de usar uma API de alto ou baixo nível.

API de baixo nível

As APIs de baixo nível correspondem às operações REST subjacentes do Amazon S3 incluindo operações de criação, atualização e exclusão em buckets e objetos. As APIs de baixo nível fornecem maior controle sobre essas operações. Por exemplo, é possível colocar as solicitações em lotes e executá-las em paralelo. Ou, ao usar a API multipart upload, você pode gerenciar as partes de objetos individualmente. Observe que essas chamadas da API de baixo nível retornam um resultado que inclui todos os detalhes da resposta do Amazon S3. Para obter mais informações sobre a API multipart upload, consulte Carregar e copiar objetos usando multipart upload.

Abstrações de alto nível

As abstrações de alto nível têm o objetivo de simplificar casos de uso comuns. Por exemplo, para fazer upload dos objetos grandes usando a API de baixo nível, você deve primeiro chamar Aws\S3\S3Client::createMultipartUpload(), em seguida, chamar o método Aws\S3\S3Client::uploadPart() para fazer upload das partes dos objetos e, em seguida, chamar o método Aws\S3\S3Client::completeMultipartUpload() para concluir o upload. Você pode usar o objeto Aws\S3\\MultipartUploader de alto nível que simplifica a criação de um multipart upload em vez disso.

Outro exemplo é quando se enumera objetos em um bucket no qual você pode usar o recurso de iteradores do AWS SDK for PHP para retornar todas as chaves de objeto, independentemente de quantos objetos foram armazenados no bucket. Se você usar a API de baixo nível, a resposta retornará, no máximo, 1.000 chaves. Se o bucket contiver mais de 1.000 objetos, o resultado ficará truncado e você terá que gerenciar a resposta e verificar o truncamento.

Executar exemplos do PHP

Para configurar e usar os exemplos do Amazon S3 para a versão 3 do AWS SDK for PHP, consulte Instalação no Guia do desenvolvedor do AWS SDK for PHP.

Recursos relacionados