기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS SDK for PHP 버전 3에 AWS 리전 대한 설정
SDK 클라이언트는 클라이언트를 생성할 때 AWS 리전 지정한 특정 AWS 서비스 의에 연결합니다. 이 구성을 사용하면 애플리케이션이 해당 지리적 영역의 AWS 리소스와 상호 작용할 수 있습니다. 리전을 명시적으로 설정하지 않고 서비스 클라이언트를 생성하면 SDK는 외부 구성의 기본 리전을 사용합니다.
리전 확인 체인
AWS SDK for PHP 버전 3에서는 다음 순서를 사용하여 서비스 클라이언트가 사용하는 리전을 결정합니다.
-
코드에 제공된 리전 - 클라이언트 생성자 옵션에서 리전을 명시적으로 설정하는 경우 다른 모든 소스보다 우선합니다.
$s3Client = new Aws\S3\S3Client([ 'region' => 'us-west-2' ]);
-
환경 변수 - 코드에 리전이 제공되지 않은 경우 SDK는 다음 환경 변수를 순서대로 확인합니다.
AWS_REGION
AWS_DEFAULT_REGION
# Example of setting Region through environment variables. export AWS_REGION=us-east-1
-
AWS 구성 파일 - 리전 환경 변수가 설정되지 않은 경우 SDK는 AWS 구성 파일을 확인합니다.
-
SDK는
~/.aws/config
(또는AWS_CONFIG_FILE
환경 변수로 지정된 위치)를 찾습니다. -
SDK는
AWS_PROFILE
환경 변수로 지정된 프로파일 내의 리전 설정을 검사합니다. -
AWS_PROFILE
를 지정하지 않으면 SDK는 "기본" 프로파일을 사용합니다.
예를 들어 다음과 같은 구성 파일 설정이 있다고 가정해 보겠습니다.
# Example ~/.aws/config file. [default] region = eu-west-1 [profile production] region = eu-central-1
AWS_PROFILE
환경 변수가 "프로덕션" 값으로 설정된 경우 클라이언트는를 사용합니다eu-central-1 Region
.AWS_PROFILE
환경 변수가 없는 경우 클라이언트는eu-west-1
리전을 사용합니다. -
-
SDK가 위의 소스에서 리전 값을 찾지 못하면 리전 값이 서비스 클라이언트에 필요한 설정이므로 예외가 발생합니다.
모범 사례
AWS SDK for PHP 버전 3에서 리전으로 작업할 때는 다음 모범 사례를 고려하세요.
- 프로덕션 코드에서 리전을 명시적으로 설정
-
프로덕션 애플리케이션의 경우 환경 변수 또는에 의존하지 않고 코드에서 리전을 명시적으로 설정하는 것이 좋습니다
config
. 이렇게 하면 코드를 더 예측할 수 있고 외부 구성에 덜 의존할 수 있습니다. - 개발 및 테스트에 환경 변수 사용
-
개발 및 테스트 환경의 경우 환경 변수를 사용하면 코드를 변경하지 않고도 유연성을 높일 수 있습니다.
- 여러 환경에 프로파일 사용
-
애플리케이션이 여러 AWS 환경에서 작동해야 하는 경우 파일에서 AWS
config
다른 프로필을 사용하고 필요에 따라 이들 간에 전환하는 것이 좋습니다.