Mengatur Wilayah AWS untuk AWS SDK untuk PHP Versi 3 - AWS SDK untuk PHP
Rantai resolusi wilayahPraktik terbaik

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengatur Wilayah AWS untuk AWS SDK untuk PHP Versi 3

Klien SDK terhubung ke Layanan AWS dalam spesifik Wilayah AWS yang Anda tentukan saat Anda membuat klien. Konfigurasi ini memungkinkan aplikasi Anda berinteraksi dengan AWS sumber daya di wilayah geografis tersebut. Saat Anda membuat klien layanan tanpa menyetel Region secara eksplisit, SDK menggunakan Region default dari konfigurasi eksternal Anda.

Rantai resolusi wilayah

AWS SDK untuk PHP Versi 3 menggunakan urutan berikut untuk menentukan Wilayah mana yang digunakan klien layanan:

  1. Wilayah disediakan dalam kode—Jika Anda secara eksplisit menyetel Wilayah dalam opsi konstruktor klien, ini lebih diutamakan daripada semua sumber lainnya.

    $s3Client = new Aws\S3\S3Client([
    'region' => 'us-west-2'
]);

  2. Variabel lingkungan—Jika tidak ada Wilayah yang disediakan dalam kode, SDK akan memeriksa variabel lingkungan ini secara berurutan:

    • AWS_REGION

    • AWS_DEFAULT_REGION

    # Example of setting Region through environment variables.
export AWS_REGION=us-east-1

  3. AWS file konfigurasi—Jika tidak ada variabel lingkungan Region yang disetel, SDK akan memeriksa file konfigurasi: AWS

    1. SDK terlihat ~/.aws/config (atau lokasi yang ditentukan oleh variabel AWS_CONFIG_FILE lingkungan)

    2. SDK memeriksa setelan wilayah dalam profil yang ditentukan oleh variabel lingkungan AWS_PROFILE

    3. Jika tidak AWS_PROFILE ditentukan, SDK menggunakan profil “default”

    Sebagai contoh, asumsikan kita memiliki pengaturan file konfigurasi berikut:

    # Example ~/.aws/config file.
[default]
region = eu-west-1

[profile production]
region = eu-central-1

    Jika variabel AWS_PROFILE lingkungan diatur dengan nilai “produksi”, klien menggunakaneu-central-1 Region. Jika tidak ada variabel AWS_PROFILE lingkungan, klien menggunakan eu-west-1 Region.

  4. Jika SDK tidak menemukan nilai Region di salah satu sumber di atas, SDK akan menampilkan pengecualian karena nilai Region adalah setelan wajib untuk klien layanan.

Praktik terbaik

Pertimbangkan praktik terbaik berikut saat bekerja dengan Wilayah di AWS SDK untuk PHP Versi 3:

Secara eksplisit mengatur Wilayah dalam kode produksi

Untuk aplikasi produksi, kami sarankan secara eksplisit mengatur Wilayah dalam kode Anda daripada mengandalkan variabel lingkungan atau. config Ini membuat kode Anda lebih dapat diprediksi dan kurang bergantung pada konfigurasi eksternal.

Gunakan variabel lingkungan untuk pengembangan dan pengujian

Untuk lingkungan pengembangan dan pengujian, menggunakan variabel lingkungan memungkinkan lebih banyak fleksibilitas tanpa mengubah kode.

Gunakan profil untuk beberapa lingkungan

Jika aplikasi Anda perlu bekerja dengan beberapa AWS lingkungan, pertimbangkan untuk menggunakan profil yang berbeda dalam AWS config file Anda dan beralih di antara mereka sesuai kebutuhan.