버전 AWS SDK for PHP 3에 대한 서비스 클라이언트 외부 구성 - AWS SDK for PHP

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

버전 AWS SDK for PHP 3에 대한 서비스 클라이언트 외부 구성

코드 외부에서 많은 구성 설정을 처리할 수 있습니다. 대부분의 구성 설정은 환경 변수 또는 별도의 공유 AWS config 파일로 설정할 수 있습니다. AWS 공유 config 파일은 프로필이라는 별도의 설정 세트를 유지하여 다양한 환경 또는 테스트에 대해 다양한 구성을 제공할 수 있습니다. AWS 공유 configcredentials 파일에 대한 자세한 설명은 AWS SDK 및 도구 참조 안내서를 참조허세요.

대부분의 환경 변수와 공유 config 파일 설정은 표준화되어 있으며 다양한 프로그래밍 언어와 애플리케이션에서 일관된 기능을 지원하기 위해 AWS SDK 및 도구 전반에 걸쳐 공유됩니다.

환경 변수 또는 구성 파일에서 SDK가 해결할 수 있는 모든 설정을 보려면 AWS SDK 및 도구 참조 안내서에 나와 있는 설정 참조를 참조하세요.

클라이언트 구성을 위한 구성 공급자 체인

SDK는 여러 위치(또는 소스)를 확인하여 구성 값을 찾습니다.

  1. 코드나 서비스 클라이언트 자체에 설정된 모든 명시적 설정은 다른 모든 설정보다 우선합니다.

  2. 환경 변수

    • 환경 변수를 설정하는 방법에 대한 자세한 내용은 AWS SDK 및 도구 참조 안내서에 나와 있는 환경 변수 섹션을 참조하세요.

    • 시스템 전체, 사용자 전체, 특정 터미널 세션 등 다양한 수준의 쉘에 대한 환경 변수를 구성할 수 있습니다.

  3. 공유 configcredentials 파일

  4. 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 SDKs에서 지원하는 크로스 SSD 설정 외에도 AWS SDK for PHP 버전 3은 다음 환경 변수와 함께 작동합니다.

AWS_SDK_LOAD_NONDEFAULT_CONFIG

설정하면이 환경 변수는 SDK에 AWS config 파일() 외에도 credentials 파일(~/.aws/config)에서 자격 증명을 로드하도록 지시~/.aws/credential합니다.

AWS_SDK_UA_APP_ID

SDK에서 수행한 요청에 대해 User-Agent 헤더에 포함될 사용자 지정 애플리케이션 식별자를 설정합니다.

AWS_SUPPRESS_PHP_DEPRECATION_WARNING

true로 설정하면 SDK에서 생성할 수 있는 PHP 사용 중단 경고가 표시되지 않습니다.