本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon Cloud9 与 适用于 PHP 的 Amazon SDK 版本 3 一起使用
<a name="cloud9"></a>

**注意**  
Amazon Cloud9 不再向新客户提供。的现有客户 Amazon Cloud9 可以继续照常使用该服务。[了解更多](https://www.amazonaws.cn/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)。

Amazon Cloud9 是一个基于 Web 的集成开发环境 (IDE)，其中包含用于在云中编码、构建、运行、测试、调试和发布软件的一系列工具。您可以使用 Amazon Cloud9 浏览器编写和运行 PHP 代码。 适用于 PHP 的 Amazon SDK Amazon Cloud9 包括代码编辑器和终端等工具。由于 Amazon Cloud9 IDE 基于云端，因此您可以使用联网的计算机在办公室、家中或任何地方处理项目。有关的一般信息 Amazon Cloud9，请参阅《[Amazon Cloud9 用户指南》](https://docs.amazonaws.cn/cloud9/latest/user-guide/welcome.html)。

按照以下说明 Amazon Cloud9 进行设置 适用于 PHP 的 Amazon SDK：
+  [第 1 步：设置 Amazon Web Services 账户 要使用 Amazon Cloud9](#cloud9-php-account) 
+  [第 2 步：设置 Amazon Cloud9 开发环境](#cloud9-php-environment) 
+  [第 3 步：设置 适用于 PHP 的 Amazon SDK](#cloud9-php-sdk) 
+  [步骤 4：下载示例代码](#cloud9-php-examples) 
+  [步骤 5：运行示例代码](#cloud9-php-run) 

## 第 1 步：设置 Amazon Web Services 账户 要使用 Amazon Cloud9
<a name="cloud9-php-account"></a>

要使用 Amazon Cloud9，请从登录到 Amazon Cloud9 控制台 Amazon Web Services 管理控制台。

**注意**  
如果您使用 Amazon IAM Identity Center 进行身份验证，则可能需要在 IAM 控制台中`iam:ListInstanceProfilesForRole`向用户附加的策略中添加所需的权限。

要在您的 Amazon 账户中设置 IAM 实体以访问 Amazon Cloud9 和登录 Amazon Cloud9 控制台，请参阅*Amazon Cloud9 用户指南 Amazon Cloud9*中的[团队设置](https://docs.amazonaws.cn/cloud9/latest/user-guide/setup.html)。

## 第 2 步：设置 Amazon Cloud9 开发环境
<a name="cloud9-php-environment"></a>

登录 Amazon Cloud9 控制台后，使用控制台创建 Amazon Cloud9 开发环境。创建环境后， Amazon Cloud9 打开该环境的 IDE。

有关详细信息，请参阅《Amazon Cloud9 用户指南》**中的[在 Amazon Cloud9中创建环境](https://docs.amazonaws.cn/cloud9/latest/user-guide/create-environment.html)。

**注意**  
在控制台中首次创建环境之后，我们建议您选择**创建新的环境实例 (EC2)**。此选项指示 Amazon Cloud9 创建环境，启动 Amazon EC2 实例，然后将新实例连接到新环境。这是开始使用的最快方法 Amazon Cloud9。

如果终端未在 IDE 中打开，请打开它。在 IDE 中的菜单栏上，选择**窗口、新终端**。您可以使用终端窗口来安装工具和构建应用程序。

## 第 3 步：设置 适用于 PHP 的 Amazon SDK
<a name="cloud9-php-sdk"></a>

 Amazon Cloud9 打开开发环境的 IDE 后，使用终端窗口 适用于 PHP 的 Amazon SDK 在您的环境中进行设置。

 Composer 是安装 适用于 PHP 的 Amazon SDK的推荐方式。Composer 是一款 PHP 工具，用于管理和安装项目的依赖项。

有关如何安装 Composer、配置自动加载并遵循定义依赖关系的其他最佳实践的更多信息，请参阅 [getcomposer.org](http://getcomposer.org)。

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

如果 Composer 未在您的项目中，请从 [Download Composer 页面](http://getcomposer.org/download)下载并安装 Composer。
+ 对于 **Windows**，请按照 Windows 安装程序说明进行操作。
+ 对于 **Linux**，请按照命令行安装说明进行操作。

### 通过 Composer 添加 适用于 PHP 的 Amazon SDK 为依赖项
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

如果您的系统上[已经全局安装了 Composer](https://getcomposer.org/doc/00-intro.md#globally)，请在项目的基目录中运行以下命令以 适用于 PHP 的 Amazon SDK 作为依赖项进行安装：

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

否则，请键入此 Composer 命令以安装最新版本的 适用于 PHP 的 Amazon SDK 作为依赖项。

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

### 将自动加载工具添加到 php 脚本
<a name="add-autoloader-to-your-php-scripts"></a>

Installing Composer 在环境中创建多个文件夹和文件。您将使用的主要文件为 `autoload.php`，位于环境中的 `vendor` 文件夹中。

要在脚本 适用于 PHP 的 Amazon SDK 中使用，请在脚本中加入自动加载器，如下所示。

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

## 步骤 4：下载示例代码
<a name="cloud9-php-examples"></a>

使用终端窗口将的示例代码下载 适用于 PHP 的 Amazon SDK 到 Amazon Cloud9 开发环境中。

要将官方 Amazon SDK 文档中使用的所有代码示例的副本下载到您环境的根目录中，请运行以下命令：

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

的代码示例位于`ENVIRONMENT_NAME/aws-doc-sdk-examples/php`目录，其中`ENVIRONMENT_NAME`是您的开发环境的名称。 适用于 PHP 的 Amazon SDK 

要继续使用 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
```

要在中打开文件 Amazon Cloud9，可以`ListBuckets.php`直接在终端窗口中单击。

有关理解代码示例的更多支持，请参阅 [适用于 PHP 的 Amazon SDK 代码示例](examples_index.md)。

## 步骤 5：运行示例代码
<a name="cloud9-php-run"></a>

要在 Amazon Cloud9 开发环境中运行代码，请选择顶部菜单栏中的 “**运行**” 按钮。 Amazon Cloud9 自动检测`.php`文件扩展名并使用 **PHP（内置 Web 服务器）**运行程序来运行代码。但是，在此示例中，我们实际上需要 **PHP（`cli`）** 选项。有关在 Amazon Cloud9中运行代码的更多信息，请参阅 *Amazon Cloud9 用户指南*中的[运行代码](https://docs.amazonaws.cn/cloud9/latest/user-guide/build-run-debug.html#build-run-debug-run)。

在下面的屏幕截图中，请注意以下基本区域：
+ 1：运行。**运行**按钮位于顶部菜单栏中。这会为结果打开新选项卡。
**注意**  
还可以手动创建新的运行配置。在菜单栏上依次选择**运行**、**运行配置**和**新建运行配置**。
+ 2：命令。 Amazon Cloud9 使用您运行的文件的路径和文件名填充**命令**文本框。如果代码需要传入任何命令行参数，则可以将这些参数添加到命令行中，方法与通过终端窗口运行代码时相同。
+ 3：跑步者。 Amazon Cloud9 检测到您的文件扩展名为，`.php`然后选择 **PHP（内置 Web 服务器）**运行程序来运行您的代码。选择 **PHP (`cli`)** 以改为运行此示例。

![\[从 Amazon Cloud9 IDE 的顶部菜单栏中选择 “运行” 将打开一个新选项卡，其中已填充命令框且已选择 PHP 运行器。\]](http://docs.amazonaws.cn/sdk-for-php/v3/developer-guide/images/cloud9_runconfig.png)


运行代码生成的任何输出都显示在选项卡中。