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

# 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';
?>
```