本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS Cloud9 搭配第 3 適用於 PHP 的 AWS SDK 版使用
<a name="cloud9"></a>

**注意**  
AWS Cloud9 不再提供給新客戶。的現有客戶 AWS Cloud9 可以繼續正常使用服務。[進一步了解。](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

AWS Cloud9 是以 Web 為基礎的整合式開發環境 (IDE)，其中包含您用來在雲端中編寫、建置、執行、測試、偵錯和發行軟體的工具集合。您可以使用 AWS Cloud9 搭配 適用於 PHP 的 AWS SDK ，使用 瀏覽器撰寫和執行 PHP 程式碼。 AWS Cloud9 包含程式碼編輯器和終端機等工具。由於 AWS Cloud9 IDE 是以雲端為基礎，因此您可以使用網際網路連線的機器，從辦公室、家中或任何地方處理專案。如需 的一般資訊 AWS Cloud9，請參閱[AWS Cloud9 《 使用者指南》](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html)。

請依照下列指示 AWS Cloud9 ，使用 設定 適用於 PHP 的 AWS SDK：
+  [步驟 1：設定您的 AWS 帳戶 以使用 AWS Cloud9](#cloud9-php-account) 
+  [步驟 2：設定您的 AWS Cloud9 開發環境](#cloud9-php-environment) 
+  [步驟 3：設定 適用於 PHP 的 AWS SDK](#cloud9-php-sdk) 
+  [步驟 4：下載範例程式碼](#cloud9-php-examples) 
+  [步驟 5：執行範例程式碼](#cloud9-php-run) 

## 步驟 1：設定您的 AWS 帳戶 以使用 AWS Cloud9
<a name="cloud9-php-account"></a>

若要使用 AWS Cloud9，請從 登入 AWS Cloud9 主控台 AWS 管理主控台。

**注意**  
如果您使用 AWS IAM Identity Center 進行身分驗證，您可能需要`iam:ListInstanceProfilesForRole`將必要的 許可新增至 IAM 主控台中的使用者連接政策。

若要在 AWS 帳戶中設定 IAM 實體以存取 AWS Cloud9 和登入 AWS Cloud9 主控台，請參閱*AWS Cloud9 《 使用者指南*》中的 [的 團隊設定 AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/setup.html)。

## 步驟 2：設定您的 AWS Cloud9 開發環境
<a name="cloud9-php-environment"></a>

登入 AWS Cloud9 主控台後，請使用 主控台來建立 AWS Cloud9 開發環境。建立環境後， AWS Cloud9 開啟該環境的 IDE。

如需詳細資訊，請參閱*AWS Cloud9 《 使用者指南*》中的在 [中建立環境 AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html)。

**注意**  
第一次由主控台建立您的環境時，建議您選擇 **Create a new instance for environment (EC2) (為環境建立新的執行個體)** 選項。此選項 AWS Cloud9 會告知 建立環境、啟動 Amazon EC2 執行個體，然後將新執行個體連線至新環境。這是開始使用 的最快方法 AWS Cloud9。

如果 IDE 中尚未開啟終端機，請開啟終端機。從 IDE 的選單列，選擇 **Window, New Terminal (視窗、新增終端機)**。您可以使用終端機視窗來安裝工具和建置您的應用程式。

## 步驟 3：設定 適用於 PHP 的 AWS SDK
<a name="cloud9-php-sdk"></a>

 AWS Cloud9 開啟開發環境的 IDE 後，請使用終端機視窗在您的 適用於 PHP 的 AWS SDK 環境中設定 。

 Composer 是安裝 的建議方法 適用於 PHP 的 AWS SDK。Composer 是適用於 PHP 的工具，可用來管理和安裝您專案的相依項目。

如需如何安裝 Composer 和設定自動載入，以及遵照其他最佳實務定義相依項目的詳細資訊，請參閱 [getcomposer.org](http://getcomposer.org)。

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

如果 Composer 尚未在您的專案中，請在 [Download Composer 頁面上下載並安裝 Composer](http://getcomposer.org/download)。
+ 對於 **Windows**，請遵循 Windows Installer 指示。
+ 對於 **Linux**，請遵循命令列安裝指示。

### 透過 Composer 新增 適用於 PHP 的 AWS SDK 做為相依性
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

如果您的系統[已全域安裝 Composer](https://getcomposer.org/doc/00-intro.md#globally)，請在專案的基本目錄中執行下列命令，以安裝 適用於 PHP 的 AWS SDK 做為相依性：

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

否則，請輸入此 Composer 命令來安裝最新版本的 適用於 PHP 的 AWS SDK 做為相依性。

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

### 將自動載入函式加入至 php 指令碼
<a name="add-autoloader-to-your-php-scripts"></a>

安裝 Composer 會在您的環境中建立多個資料夾和檔案。您會使用的主要檔案是 `autoload.php`，它位在環境的 `vendor` 資料夾中。

若要在指令碼 適用於 PHP 的 AWS SDK 中利用 ，請在指令碼中包含自動載入器，如下所示。

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

## 步驟 4：下載範例程式碼
<a name="cloud9-php-examples"></a>

使用終端機視窗將 的範例程式碼下載 適用於 PHP 的 AWS SDK 到 AWS Cloud9 開發環境中。

若要將官方 AWS SDK 文件中使用的所有程式碼範例下載到您環境的根目錄，請執行下列命令：

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

的程式碼範例 適用於 PHP 的 AWS SDK 位於 `ENVIRONMENT_NAME/aws-doc-sdk-examples/php`目錄，其中 `ENVIRONMENT_NAME`是您開發環境的名稱。

若要遵循使用 Amazon S3 範例，建議您從程式碼範例 開始`ENVIRONMENT_NAME/aws-doc-sdk-examples/php/example_code/s3/ListBuckets.php`。此範例會列出您的 Amazon S3 儲存貯體。使用終端機視窗導覽至 `s3` 目錄並列出檔案。

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

若要在 中開啟檔案 AWS Cloud9，您可以`ListBuckets.php`直接在終端機視窗中按一下 。

如需進一步了解程式碼範例的支援，請參閱[適用於 PHP 的 AWS SDK 程式碼範例](examples_index.md)。

## 步驟 5：執行範例程式碼
<a name="cloud9-php-run"></a>

若要在 AWS Cloud9 開發環境中執行程式碼，請選擇頂端選單列中的**執行**按鈕。 AWS Cloud9 會自動偵測`.php`副檔名，並使用 **PHP （內建 Web 伺服器）** 執行器執行程式碼。不過，在此範例中，我們實際上想要 **PHP (`cli`)** 選項。如需在 中執行程式碼的詳細資訊 AWS Cloud9，請參閱*AWS Cloud9 《 使用者指南*》中的[執行程式碼](https://docs.aws.amazon.com/cloud9/latest/user-guide/build-run-debug.html#build-run-debug-run)。

在下列螢幕擷取畫面中，請注意這些基本區域：
+ 1：執行。**執行**按鈕位於頂端選單列。這會開啟結果的新標籤。
**注意**  
您也可以手動建立新的執行組態。在選單列上，選擇 **Run** (執行)、**Run Configurations** (執行組態)、**New Run Configuration** (新增執行組態)。
+ 2： Command. 會將路徑和檔案名稱 AWS Cloud9 填入您所執行檔案的**命令**文字方塊。如果您的程式碼預期任何命令列參數都會傳入，這些參數可以新增到命令列，就像透過終端機視窗執行程式碼一樣。
+ 3：Runner. AWS Cloud9 偵測您的副檔名是 ，`.php`並選取 **PHP （內建 Web 伺服器）** Runner 來執行您的程式碼。選取 **PHP (`cli`)** 以改為執行此範例。

![\[從 IDE AWS Cloud9 的頂端選單列選擇執行，會開啟新的索引標籤，其中已填入命令方塊，且 PHP 執行器已選取。\]](http://docs.aws.amazon.com/zh_tw/sdk-for-php/v3/developer-guide/images/cloud9_runconfig.png)


從執行中的程式碼產生的任何輸出會顯示在 索引標籤中。