

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

# Memulai dengan AWS SDK untuk PHP Versi 3
<a name="getting-started_index"></a>

Bab ini didedikasikan untuk membuat Anda bangun dan menjalankan dengan AWS SDK untuk PHP Versi 3.

**Topics**
+ [Prasyarat](getting-started_requirements.md)
+ [Menginstal](getting-started_installation.md)
+ [Autentikasi dengan AWS](credentials.md)
+ [Membuat aplikasi sederhana](hello.md)
+ [Gunakan AWS Cloud9 dengan SDK](cloud9.md)

# Persyaratan dan rekomendasi untuk AWS SDK untuk PHP Versi 3
<a name="getting-started_requirements"></a>

Untuk hasil terbaik dengan AWS SDK untuk PHP, pastikan lingkungan Anda mendukung persyaratan dan rekomendasi berikut.

## Persyaratan
<a name="requirements"></a>

Untuk menggunakan AWS SDK untuk PHP, Anda harus menggunakan PHP versi 8.1 atau yang lebih baru dengan [ekstensi SimpleXMLPHP diaktifkan](https://www.php.net/manual/en/book.simplexml.php). Jika Anda perlu menandatangani Amazon pribadi CloudFront URLs, Anda juga memerlukan ekstensi PHP [OpenSSL](http://php.net/manual/en/book.openssl.php).

## Rekomendasi
<a name="recommendations"></a>

Selain persyaratan minimum, kami sarankan Anda juga menginstal, menghapus, dan menggunakan yang berikut ini.


****  

|  |  | 
| --- |--- |
|  Instal [cURL](http://php.net/manual/en/book.curl.php) 7.16.2 atau yang lebih baru  |  Gunakan cURL versi terbaru yang dikompilasi dengan OpenSSL/NSS dan zlib. Jika cURL tidak diinstal pada sistem Anda dan Anda tidak mengkonfigurasi http\$1handler kustom untuk klien Anda, SDK menggunakan pembungkus aliran PHP.  | 
|  Gunakan [OPCache](http://php.net/manual/en/book.opcache.php)   |  Gunakan OPcache ekstensi untuk meningkatkan kinerja PHP dengan menyimpan bytecode skrip yang telah dikompilasi dalam memori bersama. Ini menghilangkan kebutuhan PHP untuk memuat dan mengurai skrip pada setiap permintaan. Ekstensi ini biasanya diaktifkan secara default. Saat menjalankan Amazon Linux, Anda perlu menginstal paket yum php56-opcache atau php55-opcache untuk menggunakan ekstensi. OPCache   | 
|  Copot pemasangan [Xdebug](http://xdebug.org/) di lingkungan produksi   |  Xdebug dapat membantu mengidentifikasi kemacetan kinerja. Namun, jika kinerja sangat penting untuk aplikasi Anda, jangan instal ekstensi Xdebug di lingkungan produksi Anda. Memuat ekstensi sangat memperlambat kinerja SDK.  | 
|  Menggunakan autoloader classmap [Composer](http://getcomposer.org)  |  Autoloader memuat kelas seperti yang dibutuhkan oleh skrip PHP. Composer menghasilkan autoloader yang dapat memuat otomatis skrip PHP aplikasi Anda dan semua skrip PHP lainnya yang diperlukan oleh aplikasi Anda, termasuk file. AWS SDK untuk PHP Untuk lingkungan produksi, kami menyarankan Anda menggunakan autoloader classmap untuk meningkatkan performa autoloader. Anda dapat membuat autoloader classmap dengan meneruskan `==optimize-autoloader` opsi `-o` or ke perintah install Composer.  | 

## Uji kompatibilitas
<a name="compatibility-test"></a>

Jalankan [https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php](https://github.com/aws/aws-sdk-php/blob/master/compatibility-test.php)file yang terletak di basis kode SDK untuk memverifikasi sistem Anda dapat menjalankan SDK. Selain memenuhi persyaratan sistem minimum SDK, uji kompatibilitas memeriksa pengaturan opsional dan membuat rekomendasi yang dapat membantu meningkatkan kinerja. Hasil uji kompatibilitas menghasilkan baik ke baris perintah atau browser web. Saat meninjau hasil pengujian di browser, pemeriksaan yang berhasil muncul dalam warna hijau, peringatan berwarna ungu, dan kegagalan berwarna merah. Saat menjalankan dari baris perintah, hasil pemeriksaan muncul pada baris terpisah.

Saat melaporkan masalah dengan SDK, membagikan output uji kompatibilitas membantu mengidentifikasi penyebab yang mendasarinya.

# Menginstal AWS SDK untuk PHP Versi 3
<a name="getting-started_installation"></a>

Anda dapat menginstal AWS SDK untuk PHP versi 3:
+ Sebagai ketergantungan melalui Komposer
+ Sebagai phar SDK yang dikemas sebelumnya
+ Sebagai file ZIP dari SDK

Sebelum Anda menginstal AWS SDK untuk PHP Versi 3 pastikan lingkungan Anda menggunakan PHP versi 8.1 atau yang lebih baru. Pelajari lebih lanjut tentang [persyaratan dan rekomendasi lingkungan](getting-started_requirements.md).

**catatan**  
Menginstal SDK melalui metode.phar dan .zip memerlukan [ekstensi PHP Multibyte String](https://www.php.net/manual/en/book.mbstring.php) untuk diinstal dan diaktifkan secara terpisah.

## Instal AWS SDK untuk PHP sebagai dependensi melalui Composer
<a name="install-sdk-php-as-a-dependency-via-composer"></a>

 Komposer adalah cara yang disarankan untuk menginstal. AWS SDK untuk PHP Composer adalah alat untuk PHP yang mengelola dan menginstal dependensi proyek Anda.

[Untuk informasi selengkapnya tentang cara menginstal Composer, mengonfigurasi pemuatan otomatis, dan mengikuti praktik terbaik lainnya untuk menentukan dependensi, lihat getcomposer.org.](http://getcomposer.org)

### Instal Composer
<a name="install-composer"></a>

Jika Composer belum ada di proyek Anda, unduh dan instal Komposer di halaman [Download Composer](http://getcomposer.org/download).
+ Untuk **Windows**, ikuti instruksi Penginstal Windows.
+ Untuk **Linux**, ikuti instruksi instalasi baris perintah.

### Tambahkan AWS SDK untuk PHP sebagai ketergantungan melalui Komposer
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

Jika [Composer sudah diinstal secara global](https://getcomposer.org/doc/00-intro.md#globally) pada sistem Anda, jalankan yang berikut ini di direktori dasar proyek Anda untuk menginstal AWS SDK untuk PHP sebagai dependensi:

```
$ composer require aws/aws-sdk-php
```

Jika tidak, ketik perintah Composer ini untuk menginstal versi terbaru dari AWS SDK untuk PHP sebagai dependensi.

```
$ php -d memory_limit=-1 composer.phar require aws/aws-sdk-php
```

### Tambahkan autoloader ke skrip php Anda
<a name="add-autoloader-to-your-php-scripts"></a>

Menginstal Composer membuat beberapa folder dan file di lingkungan Anda. File utama yang akan Anda gunakan adalah `autoload.php`, yang ada di folder `vendor` di lingkungan Anda.

Untuk memanfaatkan skrip Anda, sertakan autoloader dalam skrip Anda, sebagai berikut. AWS SDK untuk PHP 

```
<?php
   require '/path/to/vendor/autoload.php';
?>
```

## Instalasi dengan menggunakan phar yang dikemas
<a name="installing-by-using-the-packaged-phar"></a>

Setiap rilis AWS SDK untuk PHP menyertakan phar prepackaged (arsip PHP) yang berisi semua kelas dan dependensi yang Anda butuhkan untuk menjalankan SDK. Selain itu, phar secara otomatis mendaftarkan autoloader kelas untuk AWS SDK untuk PHP dan semua dependensinya.

Anda dapat [mengunduh phar yang dikemas](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.phar) dan memasukkannya ke dalam skrip Anda.

```
<?php
   require '/path/to/aws.phar';
?>
```

**catatan**  
Menggunakan PHP dengan patch Suhosin tidak dianjurkan, tetapi umum pada distribusi Ubuntu dan Debian. Dalam hal ini, Anda mungkin perlu mengaktifkan penggunaan phars di suhosin.ini. Jika Anda tidak melakukan ini, menyertakan file phar dalam kode Anda akan menyebabkan kegagalan diam. Untuk memodifikasi suhosin.ini, tambahkan baris berikut.  

```
suhosin.executor.include.whitelist = phar
```

## Instalasi dengan menggunakan file ZIP
<a name="installing-by-using-the-zip-file"></a>

 AWS SDK untuk PHP Termasuk file ZIP yang berisi semua kelas dan dependensi yang Anda butuhkan untuk menjalankan SDK. Selain itu, file ZIP menyertakan autoloader kelas untuk AWS SDK untuk PHP dan dependensinya.

Untuk menginstal SDK, [unduh file.zip](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.zip), lalu ekstrak ke proyek Anda di lokasi yang Anda pilih. Kemudian sertakan autoloader dalam skrip Anda, sebagai berikut.

```
<?php
   require '/path/to/aws-autoloader.php';
?>
```

# Mengautentikasi dengan AWS menggunakan AWS SDK untuk PHP Versi 3
<a name="credentials"></a>

Anda harus menetapkan bagaimana kode Anda mengautentikasi AWS saat mengembangkan dengan Layanan AWS. Anda dapat mengonfigurasi akses terprogram ke AWS sumber daya dengan cara yang berbeda tergantung pada lingkungan dan AWS akses yang tersedia untuk Anda. 

Untuk memilih metode otentikasi dan mengonfigurasinya untuk SDK, lihat [Autentikasi dan akses](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) di Panduan Referensi *Alat AWS SDKs dan Alat*. 

## Menyiapkan otentikasi dengan IAM Identity Center untuk pengembangan lokal
<a name="use-idc-for-auth"></a>

Kami menyarankan agar pengguna baru yang berkembang secara lokal dan tidak diberi metode otentikasi oleh majikan mereka harus disiapkan. AWS IAM Identity Center Metode ini termasuk menginstal AWS CLI untuk kemudahan konfigurasi dan untuk masuk secara teratur ke portal AWS akses. Jika Anda memilih metode ini, lingkungan Anda harus berisi elemen-elemen berikut setelah Anda menyelesaikan prosedur untuk [autentikasi IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) di *AWS SDKs dan Panduan Referensi Alat*:
+ Itu AWS CLI, yang Anda gunakan untuk memulai sesi portal AWS akses sebelum Anda menjalankan aplikasi Anda.
+ [AWS`config`File bersama](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) yang memiliki `[default]` profil dengan serangkaian nilai konfigurasi yang dapat direferensikan oleh SDK. Untuk menemukan lokasi file ini, lihat [Lokasi file bersama di](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *Panduan Referensi Alat AWS SDKs dan*.
+  `config`File bersama berisi [https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html)pengaturan. Ini menetapkan default Wilayah AWS yang digunakan SDK untuk permintaan. Wilayah ini digunakan untuk permintaan layanan SDK yang tidak dikonfigurasi secara eksplisit dengan properti. `region` 
+  SDK menggunakan [konfigurasi penyedia token SSO](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile) profil untuk memperoleh kredensil sebelum mengirim permintaan ke. AWS`sso_role_name`Nilai, yang merupakan peran IAM yang terhubung ke set izin Pusat Identitas IAM, memungkinkan akses ke yang Layanan AWS digunakan dalam aplikasi Anda.

  `config`File contoh berikut menunjukkan profil default yang diatur dengan konfigurasi penyedia token SSO. `sso_session`Pengaturan profil mengacu pada [`sso-session`bagian](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#section-session) bernama. `sso-session`Bagian ini berisi pengaturan untuk memulai sesi portal AWS akses.

  ```
  [default]
  sso_session = my-sso
  sso_account_id = 111122223333
  sso_role_name = SampleRole
  region = us-east-1
  output = json
  
  [sso-session my-sso]
  sso_region = us-east-1
  sso_start_url = https://provided-domain.awsapps.com/start
  sso_registration_scopes = sso:account:access
  ```

Tidak AWS SDK untuk PHP memerlukan paket tambahan (seperti `SSO` dan`SSOOIDC`) untuk ditambahkan ke aplikasi Anda untuk menggunakan autentikasi IAM Identity Center.

## Memulai sesi portal AWS akses
<a name="accessportal"></a>

Sebelum menjalankan aplikasi yang mengakses Layanan AWS, Anda memerlukan sesi portal AWS akses aktif agar SDK menggunakan autentikasi IAM Identity Center untuk menyelesaikan kredensialnya. Bergantung pada panjang sesi yang dikonfigurasi, akses Anda pada akhirnya akan kedaluwarsa dan SDK akan mengalami kesalahan otentikasi. Untuk masuk ke portal AWS akses, jalankan perintah berikut di AWS CLI.

```
aws sso login
```

Jika Anda mengikuti panduan dan memiliki pengaturan profil default, Anda tidak perlu memanggil perintah dengan `--profile` opsi. Jika konfigurasi penyedia token SSO Anda menggunakan profil bernama, perintahnya adalah`aws sso login --profile named-profile`.

Untuk menguji secara opsional apakah Anda sudah memiliki sesi aktif, jalankan AWS CLI perintah berikut.

```
aws sts get-caller-identity
```

Jika sesi Anda aktif, respons terhadap perintah ini melaporkan akun Pusat Identitas IAM dan set izin yang dikonfigurasi dalam `config` file bersama.

**catatan**  
Jika Anda sudah memiliki sesi portal AWS akses aktif dan menjalankannya`aws sso login`, Anda tidak akan diminta untuk memberikan kredensil.   
Proses masuk mungkin meminta Anda untuk mengizinkan AWS CLI akses ke data Anda. Karena AWS CLI dibangun di atas SDK untuk Python, pesan izin mungkin berisi variasi nama. `botocore`

## Pelajari lebih lanjut tentang otentikasi
<a name="credother"></a>
+ *Untuk detail selengkapnya tentang menggunakan Pusat Identitas IAM untuk autentikasi, lihat [Memahami autentikasi Pusat Identitas IAM di Panduan Referensi](https://docs.aws.amazon.com/sdkref/latest/guide/understanding-sso.html) Alat dan AWS SDKs *
+ Untuk mempelajari lebih lanjut tentang praktik terbaik, lihat [Praktik terbaik keamanan di IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) di *Panduan Pengguna IAM*.
+ *Untuk membuat AWS kredensil jangka pendek, lihat [Kredenal Keamanan Sementara](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) di Panduan Pengguna IAM.*
+ Untuk mempelajari tentang penyedia kredensi lain yang AWS SDK untuk PHP dapat digunakan, lihat Penyedia [kredensi terstandarisasi di Panduan Referensi](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) Alat *AWS SDKs dan* Alat.

# Membuat aplikasi sederhana menggunakan AWS SDK untuk PHP Versi 3
<a name="hello"></a>

Sapa Amazon S3 menggunakan file. AWS SDK untuk PHP Contoh berikut menampilkan daftar bucket Amazon S3 Anda.

## Prasyarat
<a name="hello-prerequisites"></a>
+  [Unduh dan instal SDK](getting-started_installation.md) 
+ Sebelum Anda menggunakan AWS SDK untuk PHP, Anda harus mengatur otentikasi dengan AWS. Untuk informasi tentang menyiapkan autentikasi, lihat [Mengautentikasi dengan AWS menggunakan AWS SDK untuk PHP Versi 3](credentials.md)

## Menyertakan SDK dalam kode Anda
<a name="including-the-sdk-in-your-code"></a>

Apa pun teknik yang Anda gunakan untuk menginstal SDK, Anda dapat menyertakan SDK dalam kode Anda hanya dengan satu `require` pernyataan. Lihat tabel berikut untuk kode PHP yang paling sesuai dengan teknik instalasi Anda. Ganti setiap instance `/path/to/` dengan jalur aktual di sistem Anda.


****  

| Teknik Instalasi | Memerlukan Pernyataan | 
| --- | --- | 
|  Menggunakan Komposer  |   `require '/path/to/vendor/autoload.php';`   | 
|  Menggunakan phar  |   `require '/path/to/aws.phar';`   | 
|  Menggunakan ZIP  |   `require '/path/to/aws-autoloader.php';`   | 

Dalam topik ini, kita mengasumsikan metode instalasi Composer. Jika Anda menggunakan metode instalasi yang berbeda, Anda dapat merujuk kembali ke bagian ini untuk menemukan `require` kode yang benar untuk digunakan.

## Tulis kode
<a name="sdk-hello-world-code"></a>

Pastikan Anda dapat mengautentikasi.

Salin dan tempel kode berikut ke file sumber baru. Simpan dan beri nama file`hello-s3.php`.

```
<?php

require 'vendor/autoload.php';

use Aws\S3\S3Client;

/**
 * List your Amazon S3 buckets.
 */

//Create a S3Client
// snippet-start:[s3.php.list_buckets.main]
$s3Client = new S3Client([
    'profile' => 'default',
    'region' => 'us-west-2',
    'version' => '2006-03-01'
]);

//Listing all S3 Bucket
$buckets = $s3Client->listBuckets();
foreach ($buckets['Buckets'] as $bucket) {
    echo $bucket['Name'] . "\n";
}
```

## Menjalankan program
<a name="sdk-hello-world-running"></a>

Buka command prompt untuk menjalankan program PHP Anda. Sintaks perintah khas untuk menjalankan program PHP adalah: 

```
php [source filename] [arguments...]
```

Kode contoh ini tidak menggunakan argumen. Untuk menjalankan kode ini, masukkan yang berikut ini ke command prompt: 

```
$ php hello-s3.php
```

## Langkah selanjutnya
<a name="sdk-hello-world-next-steps"></a>

Untuk menguji banyak operasi Amazon S3 lainnya, lihat [Repositori Contoh AWS Kode](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/php/example_code/s3) di. GitHub

# Gunakan AWS Cloud9 dengan AWS SDK untuk PHP Versi 3
<a name="cloud9"></a>

**catatan**  
AWS Cloud9 tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada AWS Cloud9 dapat terus menggunakan layanan seperti biasa. [Pelajari selengkapnya.](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

AWS Cloud9 adalah lingkungan pengembangan terintegrasi berbasis web (IDE) yang berisi kumpulan alat yang Anda gunakan untuk membuat kode, membangun, menjalankan, menguji, men-debug, dan merilis perangkat lunak di cloud. Anda dapat menggunakan AWS Cloud9 dengan AWS SDK untuk PHP untuk menulis dan menjalankan kode PHP Anda dengan menggunakan browser. AWS Cloud9 termasuk alat-alat seperti editor kode dan terminal. Karena AWS Cloud9 IDE berbasis cloud, Anda dapat mengerjakan proyek Anda dari kantor, rumah, atau di mana saja dengan menggunakan mesin yang terhubung ke internet. Untuk informasi umum tentang AWS Cloud9, lihat [Panduan AWS Cloud9 Pengguna](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html).

Ikuti petunjuk ini untuk mengatur AWS Cloud9 dengan AWS SDK untuk PHP:
+  [Langkah 1: Siapkan Akun AWS untuk Anda gunakan AWS Cloud9](#cloud9-php-account) 
+  [Langkah 2: Siapkan lingkungan AWS Cloud9 pengembangan Anda](#cloud9-php-environment) 
+  [Langkah 3: Mengatur AWS SDK untuk PHP](#cloud9-php-sdk) 
+  [Langkah 4: Unduh kode contoh](#cloud9-php-examples) 
+  [Langkah 5: Jalankan kode contoh](#cloud9-php-run) 

## Langkah 1: Siapkan Akun AWS untuk Anda gunakan AWS Cloud9
<a name="cloud9-php-account"></a>

Untuk menggunakan AWS Cloud9, masuk ke AWS Cloud9 konsol dari file Konsol Manajemen AWS.

**catatan**  
Jika Anda menggunakan AWS IAM Identity Center untuk mengautentikasi, Anda mungkin perlu menambahkan izin yang diperlukan `iam:ListInstanceProfilesForRole` ke kebijakan yang dilampirkan pengguna di konsol IAM.

Untuk menyiapkan entitas IAM di AWS akun Anda agar dapat mengakses AWS Cloud9 dan masuk ke AWS Cloud9 konsol, lihat [Pengaturan Tim AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/setup.html) di *Panduan AWS Cloud9 Pengguna*.

## Langkah 2: Siapkan lingkungan AWS Cloud9 pengembangan Anda
<a name="cloud9-php-environment"></a>

Setelah Anda masuk ke AWS Cloud9 konsol, gunakan konsol untuk membuat lingkungan AWS Cloud9 pengembangan. Setelah Anda membuat lingkungan, AWS Cloud9 buka IDE untuk lingkungan itu.

Untuk detailnya, lihat [Membuat Lingkungan AWS Cloud9 di](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html) *Panduan AWS Cloud9 Pengguna*.

**catatan**  
Saat Anda membuat lingkungan di konsol untuk pertama kalinya, kami sarankan Anda memilih opsi untuk **Membuat instance baru untuk lingkungan (EC2)**. Opsi ini memberi tahu AWS Cloud9 untuk membuat lingkungan, meluncurkan instans Amazon EC2, dan kemudian menghubungkan instance baru ke lingkungan baru. Ini adalah cara tercepat untuk mulai menggunakan AWS Cloud9.

Jika terminal belum terbuka di IDE, buka. Pada bilah menu di IDE, pilih **Jendela, Terminal Baru**. Anda dapat menggunakan jendela terminal untuk menginstal alat dan membangun aplikasi Anda.

## Langkah 3: Mengatur AWS SDK untuk PHP
<a name="cloud9-php-sdk"></a>

Setelah AWS Cloud9 membuka IDE untuk lingkungan pengembangan Anda, gunakan jendela terminal untuk mengatur AWS SDK untuk PHP di lingkungan Anda.

 Komposer adalah cara yang disarankan untuk menginstal. AWS SDK untuk PHP Composer adalah alat untuk PHP yang mengelola dan menginstal dependensi proyek Anda.

[Untuk informasi selengkapnya tentang cara menginstal Composer, mengonfigurasi pemuatan otomatis, dan mengikuti praktik terbaik lainnya untuk menentukan dependensi, lihat getcomposer.org.](http://getcomposer.org)

### Instal Composer
<a name="install-composer"></a>

Jika Komposer belum ada di proyek Anda, unduh dan instal Komposer di halaman [Unduh Komposer](http://getcomposer.org/download).
+ Untuk **Windows**, ikuti instruksi Penginstal Windows.
+ Untuk **Linux**, ikuti instruksi instalasi baris perintah.

### Tambahkan AWS SDK untuk PHP sebagai ketergantungan melalui Komposer
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

Jika [Composer sudah diinstal secara global](https://getcomposer.org/doc/00-intro.md#globally) pada sistem Anda, jalankan yang berikut ini di direktori dasar proyek Anda untuk menginstal AWS SDK untuk PHP sebagai dependensi:

```
$ composer require aws/aws-sdk-php
```

Jika tidak, ketik perintah Composer ini untuk menginstal versi terbaru dari AWS SDK untuk PHP sebagai dependensi.

```
$ php -d memory_limit=-1 composer.phar require aws/aws-sdk-php
```

### Tambahkan autoloader ke skrip php Anda
<a name="add-autoloader-to-your-php-scripts"></a>

Menginstal Composer membuat beberapa folder dan file di lingkungan Anda. File utama yang akan Anda gunakan adalah `autoload.php`, yang ada di folder `vendor` di lingkungan Anda.

Untuk memanfaatkan skrip Anda, sertakan autoloader dalam skrip Anda, sebagai berikut. AWS SDK untuk PHP 

```
<?php
   require '/path/to/vendor/autoload.php';
?>
```

## Langkah 4: Unduh kode contoh
<a name="cloud9-php-examples"></a>

Gunakan jendela terminal untuk mengunduh kode contoh untuk AWS SDK untuk PHP ke dalam lingkungan AWS Cloud9 pengembangan.

Untuk mengunduh salinan semua contoh kode yang digunakan dalam dokumentasi AWS SDK resmi ke direktori root lingkungan Anda, jalankan perintah berikut:

```
$ git clone https://github.com/awsdocs/aws-doc-sdk-examples.git
```

Contoh kode untuk AWS SDK untuk PHP terletak di `ENVIRONMENT_NAME/aws-doc-sdk-examples/php` direktori, di mana `ENVIRONMENT_NAME` adalah nama lingkungan pengembangan Anda.

Untuk mengikuti menggunakan contoh Amazon S3, sebaiknya mulai dengan contoh kode. `ENVIRONMENT_NAME/aws-doc-sdk-examples/php/example_code/s3/ListBuckets.php` Contoh ini akan mencantumkan bucket Amazon S3 Anda. Gunakan jendela terminal untuk menavigasi ke `s3` direktori dan daftar file.

```
$ cd aws-doc-sdk-examples/php/example_code/s3
$ ls
```

Untuk membuka file di AWS Cloud9, Anda dapat mengklik `ListBuckets.php` langsung di jendela terminal.

Untuk dukungan lebih lanjut dalam memahami contoh kode, lihat [Contoh AWS SDK untuk PHP Kode](examples_index.md).

## Langkah 5: Jalankan kode contoh
<a name="cloud9-php-run"></a>

Untuk menjalankan kode di lingkungan AWS Cloud9 pengembangan Anda, pilih tombol **Run** di bilah menu atas. AWS Cloud9 secara otomatis mendeteksi ekstensi `.php` file dan menggunakan pelari **PHP (server web bawaan)** untuk menjalankan kode. Namun, untuk contoh ini kita sebenarnya menginginkan opsi **PHP (`cli`)**. Untuk informasi selengkapnya tentang menjalankan kode AWS Cloud9, lihat [Menjalankan Kode Anda](https://docs.aws.amazon.com/cloud9/latest/user-guide/build-run-debug.html#build-run-debug-run) di *Panduan AWS Cloud9 Pengguna*.

Pada tangkapan layar berikut, perhatikan area dasar ini:
+ 1: Lari. Tombol **Run** terletak di bilah menu atas. Ini membuka tab baru untuk hasil Anda. 
**catatan**  
Anda juga dapat membuat konfigurasi run baru secara manual. Pada bilah menu, pilih **Jalankan**, **Jalankan Konfigurasi**, **Jalankan Konfigurasi Baru**.
+ 2: Perintah. AWS Cloud9 mengisi kotak teks **Command** dengan path dan nama file ke file yang Anda jalankan. Jika kode Anda mengharapkan parameter baris perintah apa pun yang akan diteruskan, ini dapat ditambahkan ke baris perintah dengan cara yang sama seperti yang Anda lakukan saat menjalankan kode melalui jendela terminal.
+ 3: Pelari. AWS Cloud9 mendeteksi bahwa ekstensi file Anda `.php` dan memilih **PHP (built-in web server)** Runner untuk menjalankan kode Anda. Pilih **PHP (`cli`)** untuk menjalankan contoh ini sebagai gantinya.

![\[Memilih Run dari bilah menu atas AWS Cloud9 IDE membuka tab baru dengan kotak Command diisi dan runner PHP sudah dipilih.\]](http://docs.aws.amazon.com/id_id/sdk-for-php/v3/developer-guide/images/cloud9_runconfig.png)


Setiap output yang dihasilkan dari kode yang sedang berjalan ditampilkan di tab.