메뉴
Amazon Simple Storage Service
개발자 안내서 (API Version 2006-03-01)

PHP용 AWS SDK 사용 및 PHP 예제 실행

PHP용 AWS SDK에서는 Amazon S3 버킷 및 객체 작업용 API에 대한 액세스를 제공합니다. SDK에서는 서비스의 하위 수준 API 또는 고위 수준 추상화를 사용하는 옵션을 제공합니다.

SDK는 PHP용 AWS SDK에서 제공됩니다. 여기에는 또한 SDK 설치 및 시작하기 관련 지침도 나와 있습니다.

참고

PHP용 AWS SDK를 사용하기 위한 설정은 사용 환경과 애플리케이션을 실행하려는 방법에 따라 달라집니다. 이 설명서에 있는 예제를 실행하도록 환경을 설정하려면 PHP용 AWS SDK Getting Started Guide를 참조하십시오.

PHP용 AWS SDK 수준

하위 수준 API

하위 수준 API는 버킷 및 객체에 대한 작업의 생성, 업데이트, 삭제를 비롯하여 기본 Amazon S3 REST 작업에 적합합니다. 하위 수준 API에서는 이러한 작업에 대한 더 높은 수준의 제어를 제공합니다. 예를 들어 요청을 일괄 처리하고 이를 병렬로 실행하거나 멀티파트 업로드 API 사용 시(멀티파트 업로드 API를 사용한 객체 업로드 참조) 객체 파트를 개별적으로 관리할 수 있습니다. 이러한 하위 수준 API 호출은 Amazon S3 응답의 세부 정보가 모두 포함된 결과를 반환합니다.

상위 수준 추상화

상위 수준 추상화는 일반 사용 사례를 간소화하기 위해 마련되었습니다. 예를 들어 하위 수준 API를 사용하여 대용량 객체를 업로드하는 경우, 먼저 Aws\S3\S3Client::createMultipartUpload()를 호출한 다음 Aws\S3\S3Client::uploadPart() 메서드를 호출하여 객체 파트를 업로드한 뒤 Aws\S3\S3Client::completeMultipartUpload() 메서드를 호출하여 업로드를 완료해야 합니다. 대신 멀티파트 업로드 생성을 간소화하는 보다 상위 수준의 Aws\S3\Model\MultipartUpload\UploadBuilder 객체를 사용할 수 있습니다.

보다 상위 수준의 추상화를 사용하는 다른 예로 버킷의 객체를 열거할 때 버킷에 저장된 객체 수와 관계없이 PHP용 AWS SDK의 반복 기능을 사용하여 전체 객체 키를 반환하는 경우를 들 수 있습니다. 하위 수준 API를 사용하는 경우 응답에서는 최대 1,000개의 키를 반환하며, 버킷에 1,000개가 넘는 객체가 있는 경우 결과가 잘려나가므로 응답을 관리하여 잘린 부분이 없는지 확인해야 합니다.

PHP 예제 실행

다음 절차는 이 가이드의 PHP 코드 예제를 실행하는 방법을 설명합니다.

PHP 코드 예제를 실행하려면

1

PHP용 AWS SDK를 다운로드하여 설치한 다음 사용자 환경이 PHP용 AWS SDK Getting Started Guide에 설명되어 있는 최소 요구 사항을 충족하는지 확인합니다.

2

PHP용 AWS SDK Getting Started Guide의 지침에 따라 PHP용 AWS SDK를 설치합니다. 사용하는 설치 방법에 따라 PHP 확장에 존재하는 종속성을 해결하기 위해 코드를 수정해야 할 수 있습니다.

이 문서의 전체 PHP 코드 샘플에서는 PHP용 AWS SDK Getting Started Guide에 설명된 Composer 종속성 관리자를 사용합니다. 각 코드 샘플에는 해당 종속성을 포함하도록 다음 줄이 포함됩니다.

Copy
require 'vendor/autoload.php';

3

PHP용 AWS SDK 주제 Using the AWS credentials file and credential profiles에 설명된 대로 AWS 자격 증명의 자격 증명 프로필을 만듭니다. 런타임 시 새 Amazon S3 클라이언트 객체를 만들 때 클라이언트는 자격 증명 프로필로부터 AWS 자격 증명을 가져옵니다.

4

문서의 예제 코드를 프로젝트로 복사합니다. 사용자 환경에 따라 구성 및 SDK 파일을 참조하는 코드 예제에 줄을 추가해야 할 수 있습니다.

예를 들어 브라우저에서 PHP 예제를 로드하고 다음 코드를 PHP 코드의 맨 앞에 추가한 다음 이를 웹 애플리케이션 디렉터리(www 또는 htdocs 등)에 PHP 파일(확장명 .php)로 저장합니다.

Copy
<?php header('Content-Type: text/plain; charset=utf-8'); // Include the AWS SDK using the Composer autoloader require 'vendor/autoload.php';

5

설정에 따라 예제를 테스트합니다.

관련 리소스