기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
외부에서 AWS SDK for PHP 버전 3용 서비스 클라이언트 구성
코드 외부에서 많은 구성 설정을 처리할 수 있습니다. 대부분의 구성 설정은 환경 변수로 설정하거나 별도의 공유 AWS config 파일에서 설정할 수 있습니다. AWS 공유 config 파일은 프로필이라는 별도의 설정 세트를 유지하여 다양한 환경 또는 테스트에 대해 다양한 구성을 제공할 수 있습니다. AWS 공유 config 및 credentials 파일에 대한 자세한 설명은 AWS SDK 및 도구 참조 안내서를 참조허세요.
대부분의 환경 변수와 공유 config 파일 설정은 표준화되어 있으며 다양한 프로그래밍 언어와 애플리케이션에서 일관된 기능을 지원하기 위해 AWS SDK 및 도구 전반에 걸쳐 공유됩니다.
환경 변수 또는 구성 파일에서 SDK가 해결할 수 있는 모든 설정을 보려면 AWS SDK 및 도구 참조 안내서에 나와 있는 설정 참조를 참조하세요.
클라이언트 구성을 위한 구성 공급자 체인
SDK는 여러 위치(또는 소스)를 확인하여 구성 값을 찾습니다.
-
코드나 서비스 클라이언트 자체에 설정된 모든 명시적 설정은 다른 모든 설정보다 우선합니다.
-
환경 변수
-
환경 변수를 설정하는 방법에 대한 자세한 내용은 AWS SDK 및 도구 참조 안내서에 나와 있는 환경 변수 섹션을 참조하세요.
-
쉘 환경 변수는 시스템 전체, 사용자 전체, 특정 터미널 세션 등 다양한 수준에서 구성할 수 있습니다.
-
-
공유
config및credentials파일-
이 파일 설정에 관한 세부 사항을 알아보려면 AWS SDK 및 도구 참조 안내서에 나와 있는 공유
config및credentials파일 섹션을 참조하세요.
-
-
SDK 소스 코드 자체에서 제공하는 기본값이 마지막으로 사용됩니다.
-
리전과 같은 일부 속성에는 기본값이 없습니다. 코드, 환경 설정 또는 공유
config파일에서 명시적으로 지정해야 합니다. SDK가 필요한 구성을 해결할 수 없는 경우 API 요청이 런타임에 실패할 수 있습니다.
-
이 일반 구성 체인 외에도 AWS SDK for PHP 버전 3에는 자격 증명 공급자 체인 및 AWS 리전 해결 체인을 포함한 특수 공급자 체인도 사용됩니다. 이러한 특수 체인에는 SDK가 실행되는 환경을 고려하는 추가 공급자가 포함됩니다. 예를 들어 컨테이너나 EC2 인스턴스에서 실행되는 경우를 말합니다.
외부 설정을 사용하여 구성된 서비스 클라이언트 생성
AWS 서비스와 통신하려면 애플리케이션에 서비스 클라이언트를 생성해야 합니다. 서비스 클라이언트는 AWS 서비스와의 연결 수단으로, 복잡한 통신 세부 사항을 모두 처리하므로 사용자가 이를 걱정할 필요가 없습니다. 보안, 오류 처리 및 재시도와 같은 중요한 작업을 자동으로 처리하므로 기술적 복잡성을 처리하는 대신 애플리케이션 구축에 집중할 수 있습니다.
파라미터가 없는 생성자를 사용하여 서비스 클라이언트 구성
필요한 모든 구성 설정이 외부 소스에서 제공되는 경우 빈 생성자를 사용하여 서비스 클라이언트를 생성할 수 있습니다.
require 'vendor/autoload.php'; use Aws\S3\S3Client; $s3 = new S3Client([]);
위의 코드 스니펫은 S3Client 인스턴스를 생성합니다. 생성 중에 SDK는 구성 공급자 체인에서 설정을 찾습니다. 설정 값을 찾으면 해당 값이 사용됩니다.
기본 AWS 리전 공급자 체인과 기본 자격 증명 공급자 체인도 생성 프로세스에 사용됩니다. 체인의 어느 지점에서 SDK는 사용할 AWS 리전을 확인하고 요청에 서명하기 위한 자격 증명을 검색할 수 있는 설정을 찾아야 합니다. 이러한 값을 찾지 못하면 클라이언트 생성이 실패합니다.
AWS SDK for PHP 버전 3 환경 변수
대부분의 AWS SDK에서 지원하는 cross-sdk 설정 외에도 AWS SDK for PHP 버전 3은 다음 환경 변수와 함께 작동합니다.
- AWS_SDK_LOAD_NONDEFAULT_CONFIG
-
이 환경 변수를 설정하면 SDK는 AWS
config파일(~/.aws/config) 외에도credentials파일(~/.aws/credential)에서 자격 증명을 로드합니다. - AWS_SDK_UA_APP_ID
-
SDK에서 수행한 요청에 대해 User-Agent 헤더에 포함될 사용자 지정 애플리케이션 식별자를 설정합니다.
- AWS_SUPPRESS_PHP_DEPRECATION_WARNING
-
true로 설정하면 SDK에서 생성할 수 있는 PHP 사용 중단 경고가 표시되지 않습니다.