Mengkonfigurasi klien layanan untuk AWS SDK untuk PHP Versi 3 secara eksternal - AWS SDK untuk PHP
Rantai penyedia konfigurasi untuk konfigurasi klienBuat klien layanan yang dikonfigurasi menggunakan pengaturan eksternalAWS SDK untuk PHP Variabel lingkungan versi 3

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

Mengkonfigurasi klien layanan untuk AWS SDK untuk PHP Versi 3 secara eksternal

Banyak pengaturan konfigurasi dapat ditangani di luar kode Anda. Sebagian besar pengaturan konfigurasi dapat diatur sebagai variabel lingkungan atau dalam AWS config file bersama yang terpisah. configFile AWS bersama dapat mempertahankan set pengaturan terpisah, yang disebut profil, untuk menyediakan konfigurasi yang berbeda untuk lingkungan atau pengujian yang berbeda. Untuk diskusi lengkap tentang AWS berbagi config dan credentials file, lihat Panduan Referensi Alat AWS SDKs dan Alat.

Sebagian besar variabel lingkungan dan pengaturan config file bersama distandarisasi dan dibagikan di seluruh AWS SDKs dan alat untuk mendukung fungsionalitas yang konsisten di berbagai bahasa dan aplikasi pemrograman.

Untuk melihat semua pengaturan yang dapat diselesaikan SDK dari variabel lingkungan atau file konfigurasi, lihat referensi Pengaturan di Panduan Referensi Alat AWS SDKs dan Alat.

Rantai penyedia konfigurasi untuk konfigurasi klien

SDK memeriksa beberapa tempat (atau sumber) untuk menemukan nilai konfigurasi.

  1. Pengaturan eksplisit apa pun yang disetel dalam kode atau pada klien layanan itu sendiri lebih diutamakan daripada yang lain.

  2. Variabel-variabel lingkungan

    • Untuk detail tentang pengaturan variabel lingkungan, lihat variabel lingkungan di Panduan Referensi Alat AWS SDKs dan Alat.

    • Perhatikan bahwa Anda dapat mengonfigurasi variabel lingkungan untuk shell pada tingkat cakupan yang berbeda: seluruh sistem, seluruh pengguna, dan untuk sesi terminal tertentu.

  3. Berbagi config dan credentials file

  4. Setiap nilai default yang disediakan oleh kode sumber SDK itu sendiri digunakan terakhir.

    • Beberapa properti, seperti Region, tidak memiliki default. Anda harus menentukannya secara eksplisit dalam kode, dalam pengaturan lingkungan, atau dalam file bersamaconfig. Jika SDK tidak dapat menyelesaikan konfigurasi yang diperlukan, permintaan API dapat gagal saat runtime.

Selain rantai konfigurasi umum ini, AWS SDK untuk PHP Versi 3 juga menggunakan rantai penyedia khusus termasuk rantai penyedia kredensil dan rantai Wilayah AWS resolusi. Rantai khusus ini menambahkan penyedia tambahan yang memperhitungkan lingkungan tempat SDK berjalan. Misalnya, dalam wadah atau EC2 instance.

Buat klien layanan yang dikonfigurasi menggunakan pengaturan eksternal

Anda perlu membuat klien layanan di aplikasi Anda untuk berbicara dengan Layanan AWS. Pelanggan layanan adalah koneksi penting Anda Layanan AWS, menangani semua detail komunikasi yang kompleks sehingga Anda tidak perlu khawatir tentang mereka. Mereka menangani tugas-tugas penting seperti keamanan, penanganan kesalahan, dan percobaan ulang secara otomatis, memungkinkan Anda fokus pada membangun aplikasi Anda daripada berurusan dengan komplikasi teknis.

Membangun klien layanan menggunakan konstruktor tanpa parameter

Jika semua pengaturan konfigurasi yang Anda butuhkan berasal dari sumber eksternal, Anda dapat membuat klien layanan dengan menggunakan konstruktor kosong:

require 'vendor/autoload.php';

use Aws\S3\S3Client;

$s3 = new S3Client([]);

Cuplikan kode sebelumnya membuat sebuah S3Client instance. Selama pembuatan, SDK melihat melalui rantai penyedia konfigurasi untuk pengaturan. Setelah SDK menemukan nilai setelan, SDK menggunakan nilainya.

Rantai Wilayah AWS penyedia default dan rantai penyedia kredensi default juga akan digunakan dalam proses pembuatan. Di suatu tempat dalam rantai, SDK harus menyelesaikan pengaturan yang akan digunakan dan menemukan yang Wilayah AWS memungkinkannya mengambil kredensil untuk permintaan penandatanganan. Jika SDKs file untuk menemukan nilai-nilai tersebut, pembuatan klien gagal.

AWS SDK untuk PHP Variabel lingkungan versi 3

Di luar pengaturan cross-sdk yang didukung oleh sebagian besar AWS SDKs, AWS SDK untuk PHP Versi 3 bekerja dengan variabel lingkungan berikut:

AWS_SDK_LOAD_NONDEFAULT_CONFIG

Saat disetel, variabel lingkungan ini menginstruksikan SDK untuk memuat kredensil dari AWS config file (~/.aws/config) selain credentials file. ~/.aws/credential

AWS_SDK_UA_APP_ID

Menetapkan pengenal aplikasi kustom yang disertakan dalam header User-Agent untuk permintaan yang dibuat oleh SDK.

AWS_SUPPRESS_PHP_DEPRECATION_WARNING

Ketika disetel ke true, menekan peringatan penghentian PHP yang mungkin dihasilkan SDK.