

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS SDK for PHP 버전 3 시작하기
<a name="getting-started_index"></a>

이 장에서는 AWS SDK for PHP 버전 3을 준비하고 실행하는 과정만 다룹니다.

**Topics**
+ [사전 조건](getting-started_requirements.md)
+ [설치](getting-started_installation.md)
+ [를 사용하여 인증 AWS](credentials.md)
+ [샘플 애플리케이션 생성](hello.md)
+ [SDK와 AWS Cloud9 함께 사용](cloud9.md)

# AWS SDK for PHP 버전 3의 요구 사항 및 권장 사항
<a name="getting-started_requirements"></a>

최상의 결과를 얻으려면 환경이 다음 요구 사항 및 권장 사항을 지원하는지 AWS SDK for PHP확인하세요.

## 요구 사항
<a name="requirements"></a>

를 사용하려면 [SimpleXML PHP 확장이 활성화된 상태에서 PHP](https://www.php.net/manual/en/book.simplexml.php) 버전 8.1 이상을 사용해야 AWS SDK for PHP합니다. 프라이빗 Amazon CloudFront URL에 서명해야 하는 경우 [OpenSSL PHP 확장](http://php.net/manual/en/book.openssl.php)도 필요합니다.

## 권장 사항
<a name="recommendations"></a>

최소 요건에 더해, 다음을 설치, 제거, 사용하는 것이 좋습니다.


****  

|  |  | 
| --- |--- |
|  [cURL](http://php.net/manual/en/book.curl.php) 7.16.2 이상 설치  |  OpenSSL/NSS 및 zlib로 컴파일된 최신 버전의 cURL을 사용합니다. cURL이 시스템에 설치되어 있지 않고 클라이언트에 대한 사용자 지정 http\$1handler를 구성하지 않은 경우 SDK에서는 PHP 시스템 래퍼를 사용합니다.  | 
|  [OPCache](http://php.net/manual/en/book.opcache.php) 사용   |  공유 메모리에 미리 컴파일된 스크립트 바이트코드를 저장하여 PHP 성능을 개선하려면 OPcache 확장을 사용합니다. 그러면 PHP에서 각 요청에 대해 스크립트를 로드하여 구문 분석할 필요가 없습니다. 이 확장은 기본적으로 활성화됩니다. Amazon Linux를 실행할 경우 OPCache 확장을 사용하려면 php56-opcache 또는 php55-opcache yum 패키지를 설치해야 합니다.  | 
|  프로덕션 환경에서 [Xdebug](http://xdebug.org/) 제거   |  Xdebug를 사용하면 성능 병목 현상을 파악할 수 있습니다. 하지만 성능이 애플리케이션에 중요한 경우 Xdebug 확장을 프로덕션 환경에 설치하지 마세요. 확장을 로드하면 SDK 성능이 매우 느려집니다.  | 
|  [Composer](http://getcomposer.org) 클래스맵 자동 로더 사용  |  자동 로더는 PHP 스크립트에 요구된 클래스를 로드합니다. Composer는 AWS SDK for PHP를 비롯하여 애플리케이션의 PHP 스크립트와 애플리케이션에 필요한 모든 다른 PHP 스크립트를 자동으로 로드할 수 있는 자동 로더를 생성합니다. 프로덕션 환경에서는 클래스맵 자동 로더를 사용하여 자동 로더 성능을 개선하는 것이 좋습니다. `-o` 또는 `==optimize-autoloader` 옵션을 Composer의 설치 명령에 전달하여 클래스맵 자동 로더를 생성할 수 있습니다.  | 

## 호환성 테스트
<a name="compatibility-test"></a>

SDK 코드 베이스에 위치한 [https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php](https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php) 파일을 실행하여 시스템에서 SDK를 실행할 수 있는지 확인합니다. SDK의 최소 시스템 요구 사항을 충족하는 것 외에도 호환성 테스트에서는 선택적 설정을 검사하고 성능을 개선할 수 있는 권장 사항을 제공합니다. 호환성 테스트 결과는 명령줄 또는 웹 브라우저에 출력됩니다. 브라우저에서 테스트 결과를 검토할 경우 성공적인 검사는 녹색, 경고는 보라색, 실패는 빨간색으로 표시됩니다. 명령줄에서 실행할 경우 검사 결과가 별도의 줄에 표시됩니다.

SDK에서 문제를 보고할 때 호환성 테스트 출력을 공유하면 근본적인 이유를 파악하는 데 도움이 됩니다.

# AWS SDK for PHP 버전 3 설치
<a name="getting-started_installation"></a>

 AWS SDK for PHP 버전 3을 설치할 수 있습니다.
+ Composer를 통한 종속 항목 이용
+ 사전 패키지된 SDK의 phar 이용
+ SDK의 ZIP 파일 이용

 AWS SDK for PHP 버전 3을 설치하기 전에 환경에서 PHP 버전 8.1 이상을 사용하고 있는지 확인합니다. [환경의 요구 사항 및 권장 사항](getting-started_requirements.md)에 대해 자세히 알아봅니다.

**참고**  
.phar 및.zip 메서드를 통해 SDK를 설치하려면 [Multibyte String PHP](https://www.php.net/manual/en/book.mbstring.php) 확장을 별도로 설치하고 활성화해야 합니다.

## Composer를 통해 종속성 AWS SDK for PHP 으로 설치
<a name="install-sdk-php-as-a-dependency-via-composer"></a>

 Composer를 통해 AWS SDK for PHP를 설치하는 것이 좋습니다. Composer는 프로젝트의 종속 항목을 관리 및 설치하는 PHP용 도구입니다.

Composer를 설치하고, 자동 로딩을 구성하고, 각종 모범 사례에 따라 종속 항목을 정의하는 방법에 대한 자세한 내용은 [getcomposer.org](http://getcomposer.org)를 참조하세요.

### Composer 설치
<a name="install-composer"></a>

프로젝트에 Composer가 없는 경우, [Composer 다운로드 페이지](http://getcomposer.org/download)에서 Composer를 다운로드 및 설치하세요.
+ **Windows**의 경우, Windows 설치 프로그램 지침을 따르세요.
+ **Linux**의 경우 명령줄 설치 지침을 따르세요.

### Composer를 통해 종속성 AWS SDK for PHP 으로 추가
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

[Composer가 시스템에 이미 전역적으로 설치되어](https://getcomposer.org/doc/00-intro.md#globally) 있는 경우 프로젝트의 기본 디렉터리에서 다음을 실행하여를 종속 항목 AWS SDK for PHP 으로 설치합니다.

```
$ composer require aws/aws-sdk-php
```

그렇지 않으면 이 Composer 명령을 입력하여 AWS SDK for PHP 최신 버전을 종속 항목으로 설치합니다.

```
$ php -d memory_limit=-1 composer.phar require aws/aws-sdk-php
```

### php 스크립트에 자동 로더 추가
<a name="add-autoloader-to-your-php-scripts"></a>

Composer 설치 작업은 사용자 환경에 여러 폴더와 파일을 만듭니다. 사용할 주 파일은 `autoload.php`이고 환경의 `vendor` 폴더에 있습니다.

스크립트 AWS SDK for PHP 에서를 활용하려면 다음과 같이 스크립트에 오토로더를 포함합니다.

```
<?php
   require '/path/to/vendor/autoload.php';
?>
```

## 패키지드 Phar를 사용하여 설치
<a name="installing-by-using-the-packaged-phar"></a>

의 각 릴리스 AWS SDK for PHP 에는 SDK를 실행하는 데 필요한 모든 클래스와 종속성이 포함된 사전 패키징된 phar(PHP 아카이브)가 포함되어 있습니다. 또한 phar는 AWS SDK for PHP 및 모든 종속성에 대한 클래스 오토로더를 자동으로 등록합니다.

[패키지된 phar를 다운로드](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.phar)하여 스크립트에 포함시킬 수 있습니다.

```
<?php
   require '/path/to/aws.phar';
?>
```

**참고**  
Suhosin 패치를 적용한 PHP는 사용하지 않는 것이 좋지만, Ubuntu 및 Debian 배포에서는 일반적으로 사용됩니다. 이 경우 suhosin.ini에서 phar 사용을 활성화해야 할 수도 있습니다. 그렇지 않을 경우 코드에 phar 파일을 포함하면 자동으로 실패합니다. suhosin.ini를 수정하려면 다음 줄을 추가합니다.  

```
suhosin.executor.include.whitelist = phar
```

## ZIP 파일을 사용하여 설치
<a name="installing-by-using-the-zip-file"></a>

에는 SDK를 실행하는 데 필요한 모든 클래스와 종속성이 포함된 ZIP 파일이 AWS SDK for PHP 포함되어 있습니다. 또한 이 ZIP 파일에는 AWS SDK for PHP 및 종속 항목을 위한 클래스 자동 로더도 들어 있습니다.

SDK를 설치하려면 [.zip 파일을 다운로드](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.zip)한 다음 선택한 위치에 프로젝트로 풀어 놓습니다. 그런 다음 아래와 같이 스크립트에 자동 로더를 포함시킵니다.

```
<?php
   require '/path/to/aws-autoloader.php';
?>
```

# AWS SDK for PHP 버전 3을 AWS 사용하여 로 인증
<a name="credentials"></a>

를 사용하여 개발할 AWS 때 코드가 로 인증되는 방법을 설정해야 합니다 AWS 서비스. 환경 및 사용 가능한 액세스에 따라 다양한 방식으로 AWS 리소스에 대한 프로그래밍 방식 AWS 액세스를 구성할 수 있습니다.

인증 방법을 선택하고 SDK에 맞게 구성하려면AWS SDK 및 도구 참조 안내서**의 [Authentication and access](https://docs.aws.amazon.com/sdkref/latest/guide/access.html)를 참조하세요.

## 로컬 개발용 IAM Identity Center 인증 설정
<a name="use-idc-for-auth"></a>

로컬에서 개발 중이고 고용주로부터 인증 방법을 받지 않은 신규 사용자는 설정해야 합니다 AWS IAM Identity Center. 이 방법에는 구성이 쉽고 AWS 액세스 포털 AWS CLI 에 정기적으로 로그인하기 위한 설치가 포함됩니다. 이 방법을 선택하는 경우AWS SDK 및 도구 참조 안내서**의 [IAM Identity Center authentication](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) 절차를 완료한 후 환경에 다음 요소가 포함되어야 합니다.
+ 애플리케이션을 실행하기 전에 AWS 액세스 포털 세션을 시작하는 데 AWS CLI사용하는 입니다.
+ SDK에서 참조할 수 있는 구성 값 세트가 포함된 `[default]` 프로필이 있는 [공유 AWS`config` 파일](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)입니다. 이 파일의 위치를 찾으려면 **AWS SDK 및 도구 참조 가이드에서 [공유 파일의 위치](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html)를 참조하세요.
+  공유 `config` 파일에는 [https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) 설정이 포함됩니다. 이렇게 하면 SDK AWS 리전 가 요청에 사용하는 기본값이 설정됩니다. 이 리전은 `region` 속성으로 명시적으로 구성되지 않은 SDK 서비스 요청에 사용됩니다.
+  SDK는 AWS에 요청을 보내기 전에 프로필의 [SSO token provider configuration](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile)을 사용하여 보안 인증을 얻습니다. IAM Identity Center 권한 세트에 연결된 IAM 역할인 `sso_role_name` 값은 애플리케이션에 AWS 서비스 사용되는에 대한 액세스를 허용합니다.

  다음 샘플 `config` 파일은 SSO 토큰 공급자 구성으로 설정된 기본 프로필을 보여줍니다. 프로필의 `sso_session` 설정은 이름이 지정된 [`sso-session` section](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#section-session)을 참조합니다. `sso-session` 섹션에는 AWS 액세스 포털 세션을 시작하는 설정이 포함되어 있습니다.

  ```
  [default]
  sso_session = my-sso
  sso_account_id = 111122223333
  sso_role_name = SampleRole
  region = us-east-1
  output = json
  
  [sso-session my-sso]
  sso_region = us-east-1
  sso_start_url = https://provided-domain.awsapps.com/start
  sso_registration_scopes = sso:account:access
  ```

 AWS SDK for PHP 에서는 IAM Identity Center 인증을 사용하기 위해 애플리케이션에 추가 패키지(예: `SSO` 및 `SSOOIDC`)를 추가할 필요가 없습니다.

## AWS 액세스 포털 세션 시작
<a name="accessportal"></a>

에 액세스하는 애플리케이션을 실행하기 전에 SDK가 IAM Identity Center 인증을 사용하여 자격 증명을 확인하려면 활성 AWS 액세스 포털 세션이 AWS 서비스필요합니다. 구성된 세션 길이에 따라 결국 액세스가 만료되고 SDK에 인증 오류가 발생합니다. AWS 액세스 포털에 로그인하려면에서 다음 명령을 실행합니다 AWS CLI.

```
aws sso login
```

지침에 따라 기본 프로필을 설정했다면 `--profile` 옵션으로 명령을 직접적으로 호출할 필요가 없습니다. SSO 토큰 공급자 구성에서 명명된 프로필을 사용하는 경우 `aws sso login --profile named-profile` 명령을 사용합니다.

활성 세션이 이미 있는지 선택적으로 테스트하려면 다음 AWS CLI 명령을 실행합니다.

```
aws sts get-caller-identity
```

세션이 활성 상태인 경우 이 명령에 대한 응답은 공유 `config` 파일에 구성된 IAM Identity Center 계정 및 권한 집합을 보고합니다.

**참고**  
이미 활성 AWS 액세스 포털 세션이 있고를 실행하는 경우 `aws sso login`자격 증명을 제공할 필요가 없습니다.  
로그인 프로세스에서 데이터에 대한 AWS CLI 액세스를 허용하라는 메시지가 표시될 수 있습니다. AWS CLI 는 SDK for Python을 기반으로 구축되므로 권한 메시지에 `botocore` 이름의 변형이 포함될 수 있습니다.

## 인증에 대해 자세히 알아봅니다.
<a name="credother"></a>
+ IAM Identity Center를 인증에 사용하는 방법에 대한 자세한 내용은 **AWS SDK 및 도구 참조 안내서에서 [IAM Identity Center 인증 이해하기](https://docs.aws.amazon.com/sdkref/latest/guide/understanding-sso.html)를 참조하세요.
+ 모범 사례에 대해 자세히 알아보려면 **IAM 사용 설명서에서 [IAM의 보안 모범 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)를 참조하세요.
+ 단기 AWS 자격 증명을 생성하려면 *IAM 사용 설명서*의 [임시 보안 자격 증명을 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html).
+  AWS SDK for PHP 에서 사용할 수 있는 기타 자격 증명 공급자에 관해 알아보려면 **AWS SDK 및 도구 참조 안내서에서 [표준화된 보안 인증 공급자](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) 섹션을 참조하세요.

# AWS SDK for PHP 버전 3을 사용하여 간단한 애플리케이션 생성
<a name="hello"></a>

AWS SDK for PHP를 사용하여 Amazon S3에 인사하세요. 다음 예제에서는 모든 Amazon S3 버킷의 목록을 표시합니다.

## 사전 조건
<a name="hello-prerequisites"></a>
+  [SDK 다운로드 및 설치](getting-started_installation.md) 
+ AWS SDK for PHP를 사용하기 전에 AWS 인증을 받아야 합니다. CHAP 인증 설정에 대한 자세한 내용은 [AWS SDK for PHP 버전 3을 AWS 사용하여 로 인증](credentials.md)를 참조하세요

## 코드에 SDK 포함
<a name="including-the-sdk-in-your-code"></a>

어떤 기술을 사용하여 SDK를 설치했든 상관없이, 단일 `require` 문을 사용하여 SDK를 코드에 포함할 수 있습니다. 설치 기법에 가장 적합한 PHP 코드를 찾으려면 다음 표를 참조하세요. `/path/to/`의 인스턴스를 시스템의 실제 경로로 바꿉니다.


****  

| 설치 기법 | Require 명령문 | 
| --- | --- | 
|  생성자 사용  |   `require '/path/to/vendor/autoload.php';`   | 
|  phar 사용  |   `require '/path/to/aws.phar';`   | 
|  ZIP 사용  |   `require '/path/to/aws-autoloader.php';`   | 

이 항목에서는 Composer 설치 방법을 가정하는 예제를 보여 줍니다. 다른 설치 방법을 사용하는 경우 이 단원으로 돌아와서 사용할 올바른 `require` 코드를 찾을 수 있습니다.

## 코드 쓰기
<a name="sdk-hello-world-code"></a>

인증이 가능한지 확인합니다.

다음 코드를 복사하여 새로운 소스 파일에 붙여 넣습니다. 이 파일을 저장하고 이름을 `hello-s3.php`로 지정합니다.

```
<?php

require 'vendor/autoload.php';

use Aws\S3\S3Client;

/**
 * List your Amazon S3 buckets.
 */

//Create a S3Client
// snippet-start:[s3.php.list_buckets.main]
$s3Client = new S3Client([
    'profile' => 'default',
    'region' => 'us-west-2',
    'version' => '2006-03-01'
]);

//Listing all S3 Bucket
$buckets = $s3Client->listBuckets();
foreach ($buckets['Buckets'] as $bucket) {
    echo $bucket['Name'] . "\n";
}
```

## 프로그램 실행
<a name="sdk-hello-world-running"></a>

명령 프롬프트를 PHP 프로그램을 실행합니다. PHP 프로그램을 실행하는 일반적인 명령 구문은 다음과 같습니다.

```
php [source filename] [arguments...]
```

이 샘플 코드는 인수를 사용하지 않습니다. 이 코드를 실행하려면 명령 프롬프트에 다음을 입력합니다.

```
$ php hello-s3.php
```

## 다음 단계
<a name="sdk-hello-world-next-steps"></a>

다른 많은 Amazon S3 작업을 테스트하려면 GitHub의 [AWS 코드 예제 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/php/example_code/s3)를 확인하세요.

# AWS SDK for PHP 버전 3과 AWS Cloud9 함께 사용
<a name="cloud9"></a>

**참고**  
AWS Cloud9 는 더 이상 신규 고객이 사용할 수 없습니다. 의 기존 고객은 평소와 같이 서비스를 계속 사용할 AWS Cloud9 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

AWS Cloud9 는 클라우드에서 소프트웨어를 코딩, 빌드, 실행, 테스트, 디버그 및 릴리스하는 데 사용하는 도구 모음이 포함된 웹 기반 통합 개발 환경(IDE)입니다. 와 AWS Cloud9 함께 AWS SDK for PHP 를 사용하여 브라우저를 사용하여 PHP 코드를 작성하고 실행할 수 있습니다. 코드 편집기 및 터미널과 같은 도구를 AWS Cloud9 포함합니다. AWS Cloud9 IDE는 클라우드 기반이므로 인터넷에 연결된 시스템을 사용하여 사무실, 집 또는 어디서나 프로젝트 작업을 수행할 수 있습니다. 에 대한 일반적인 내용은 [AWS Cloud9 사용 설명서를](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html) AWS Cloud9참조하세요.

 AWS SDK for PHP다음 지침에 따라를 설정합니다 AWS Cloud9 .
+  [1단계: AWS 계정 를 사용하도록 설정 AWS Cloud9](#cloud9-php-account) 
+  [2단계: AWS Cloud9 개발 환경 설정](#cloud9-php-environment) 
+  [3단계: 설정 AWS SDK for PHP](#cloud9-php-sdk) 
+  [4단계: 예제 코드 다운로드](#cloud9-php-examples) 
+  [5단계: 예제 코드 실행](#cloud9-php-run) 

## 1단계: AWS 계정 를 사용하도록 설정 AWS Cloud9
<a name="cloud9-php-account"></a>

를 사용하려면에서 AWS Cloud9 콘솔에 AWS Cloud9로그인합니다 AWS Management Console.

**참고**  
 AWS IAM Identity Center 를 사용하여 인증하는 경우 IAM 콘솔에서 사용자 연결 정책에의 필수 권한을 추가해야 `iam:ListInstanceProfilesForRole` 할 수 있습니다.

콘솔에 액세스 AWS Cloud9 하고 로그인하도록 AWS 계정의 IAM 엔터티를 AWS Cloud9 설정하려면 *AWS Cloud9 사용 설명서*의에 [대한 팀 설정을 AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/setup.html) 참조하세요.

## 2단계: AWS Cloud9 개발 환경 설정
<a name="cloud9-php-environment"></a>

 AWS Cloud9 콘솔에 로그인한 후 콘솔을 사용하여 AWS Cloud9 개발 환경을 생성합니다. 환경을 생성한 후는 해당 환경의 IDE를 AWS Cloud9 엽니다.

자세한 내용은AWS Cloud9 사용 설명서**의 [AWS Cloud9에서 환경 생성](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html)을 참조하세요.

**참고**  
콘솔에서 처음으로 환경을 생성할 때 **Create a new instance for environment (EC2)(환경에 대한 새 인스턴스 생성(EC2))** 옵션을 선택하는 것이 좋습니다. 이 옵션은 AWS Cloud9 에 환경을 생성하고 Amazon EC2 인스턴스를 시작한 다음 새 인스턴스를 새 환경에 연결하도록 지시합니다. 이것이 사용을 시작하는 가장 빠른 방법입니다 AWS Cloud9.

터미널이 IDE에 아직 열려 있지 않은 경우 엽니다. IDE의 메뉴 모음에서 **Window, New Terminal(창, 새 터미널)**을 선택합니다. 터미널 창을 사용하여 도구를 설치하고 애플리케이션을 빌드할 수 있습니다.

## 3단계: 설정 AWS SDK for PHP
<a name="cloud9-php-sdk"></a>

가 개발 환경의 IDE를 AWS Cloud9 열면 터미널 창을 사용하여 환경에서 AWS SDK for PHP 를 설정합니다.

 Composer를 통해 AWS SDK for PHP를 설치하는 것이 좋습니다. Composer는 프로젝트의 종속 항목을 관리 및 설치하는 PHP용 도구입니다.

Composer를 설치하고, 자동 로딩을 구성하고, 각종 모범 사례에 따라 종속 항목을 정의하는 방법에 대한 자세한 내용은 [getcomposer.org](http://getcomposer.org)를 참조하세요.

### Composer 설치
<a name="install-composer"></a>

프로젝트에 Composer가 없는 경우, [Composer 다운로드 페이지](http://getcomposer.org/download)에서 Composer를 다운로드 및 설치하세요.
+ **Windows**의 경우, Windows 설치 프로그램 지침을 따르세요.
+ **Linux**의 경우 명령줄 설치 지침을 따르세요.

### Composer를 통해 종속성 AWS SDK for PHP 으로 추가
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

[Composer가 시스템에 이미 전역적으로 설치되어](https://getcomposer.org/doc/00-intro.md#globally) 있는 경우 프로젝트의 기본 디렉터리에서 다음을 실행하여를 종속 항목 AWS SDK for PHP 으로 설치합니다.

```
$ composer require aws/aws-sdk-php
```

그렇지 않으면 이 Composer 명령을 입력하여 AWS SDK for PHP 최신 버전을 종속 항목으로 설치합니다.

```
$ php -d memory_limit=-1 composer.phar require aws/aws-sdk-php
```

### php 스크립트에 자동 로더 추가
<a name="add-autoloader-to-your-php-scripts"></a>

Composer 설치 작업은 사용자 환경에 여러 폴더와 파일을 만듭니다. 사용할 주 파일은 `autoload.php`이고 환경의 `vendor` 폴더에 있습니다.

스크립트 AWS SDK for PHP 에서를 활용하려면 다음과 같이 스크립트에 오토로더를 포함합니다.

```
<?php
   require '/path/to/vendor/autoload.php';
?>
```

## 4단계: 코드 예 다운로드
<a name="cloud9-php-examples"></a>

터미널 창을 사용하여의 예제 코드를 개발 환경에 다운로드 AWS SDK for PHP 합니다 AWS Cloud9 .

공식 AWS SDK 설명서에 사용된 모든 코드 예제의 사본을 환경의 루트 디렉터리에 다운로드하려면 다음 명령을 실행합니다.

```
$ git clone https://github.com/awsdocs/aws-doc-sdk-examples.git
```

의 코드 예제 AWS SDK for PHP 는 `ENVIRONMENT_NAME/aws-doc-sdk-examples/php` 디렉터리에 있으며, 여기서 `ENVIRONMENT_NAME`는 개발 환경의 이름입니다.

Amazon S3 예제를 사용하여 따라하려면 코드 `ENVIRONMENT_NAME/aws-doc-sdk-examples/php/example_code/s3/ListBuckets.php` 예제로 시작하는 것이 좋습니다. 이 예제에서는 Amazon S3 버킷을 나열합니다. 터미널 창을 사용하여 `s3` 디렉터리로 이동하여 파일을 나열합니다.

```
$ cd aws-doc-sdk-examples/php/example_code/s3
$ ls
```

에서 파일을 열려면 터미널 창에서 `ListBuckets.php` 직접를 AWS Cloud9클릭합니다.

코드 예제를 이해하는 데 도움이 더 필요하면 [AWS SDK for PHP 코드 예제](examples_index.md)를 참조하세요.

## 5단계: 예제 코드 실행
<a name="cloud9-php-run"></a>

 AWS Cloud9 개발 환경에서 코드를 실행하려면 상단 메뉴 모음에서 **실행** 버튼을 선택합니다.는 `.php` 파일 확장명을 AWS Cloud9 자동으로 감지하고 **PHP(내장 웹 서버)** 러너를 사용하여 코드를 실행합니다. 하지만 이 예제에서는 실제로 **PHP(`cli`)** 옵션이 필요합니다. AWS Cloud9에서 코드 실행에 대한 자세한 정보는 *AWS Cloud9 사용 설명서*.의 [코드 실행](https://docs.aws.amazon.com/cloud9/latest/user-guide/build-run-debug.html#build-run-debug-run)을 참조하세요.

다음 스크린샷에서 이러한 기본 영역을 확인하세요.
+ 1: 실행. **실행** 버튼은 상단 메뉴 표시줄에 있습니다. 이 버튼은 결과를 볼 수 있는 새 탭을 엽니다.
**참고**  
또한 새 실행 구성을 수동으로 생성할 수 있습니다. 메뉴 표시줄에서 **실행**, **실행 구성**, **새 실행 구성**을 선택합니다.
+ 2: Command.는 실행하는 파일의 경로와 파일 이름으로 **명령** 텍스트 상자를 AWS Cloud9 채웁니다. 코드에서 명령줄 파라미터가 전달될 것으로 예상하는 경우 터미널 창을 통해 코드를 실행할 때와 동일한 방식으로 명령줄 파라미터를 명령줄에 추가할 수 있습니다.
+ 3: Runner. AWS Cloud9 detects your file extension is `.php` and selects the **PHP(내장 웹 서버)** Runner를 선택하여 코드를 실행합니다. 이 예제를 대신 실행하려면 **PHP(`cli`)** 를 선택하세요.

![\[AWS Cloud9 IDE의 상단 메뉴 모음에서 실행을 선택하면 명령 상자가 채워지고 PHP 실행기가 이미 선택된 새 탭이 열립니다.\]](http://docs.aws.amazon.com/ko_kr/sdk-for-php/v3/developer-guide/images/cloud9_runconfig.png)


실행 코드에서 생성된 모든 출력이 탭에 표시됩니다.