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

# 使用适用于 PHP 的 AWS SDK 版本 3 创建简单的应用程序
<a name="hello"></a>

使用 适用于 PHP 的 AWS SDK 来给 Amazon S3 打招呼。以下示例显示了 Amazon S3 存储桶的列表。

## 先决条件
<a name="hello-prerequisites"></a>
+  [下载并安装 SDK](getting-started_installation.md) 
+ 使用适用于 PHP 的 AWS SDK 之前，必须先使用 AWS 设置身份验证。有关设置身份验证的信息，请参阅 [AWS 使用 适用于 PHP 的 AWS SDK 版本 3 进行身份验证](credentials.md)

## 在您的代码中包含 SDK
<a name="including-the-sdk-in-your-code"></a>

无论您使用哪种方式安装开发工具包，都可以通过单独的 `require` 语句在您的代码中包含开发工具包。请参阅以下 PHP 代码表，了解符合您的安装方式的代码。请使用系统的实际路径替换 `/path/to/` 的任何实例。


****  

| 安装方法 | 所需语句 | 
| --- | --- | 
|  使用 Composer  |   `require '/path/to/vendor/autoload.php';`   | 
|  使用 phar  |   `require '/path/to/aws.phar';`   | 
|  使用 ZIP  |   `require '/path/to/aws-autoloader.php';`   | 

在此主题中，我们假设了 Composer 安装方法。如果您使用其他安装方法，可以回到这一部分来查找应使用的正确 `require` 代码。

## 编写代码
<a name="sdk-hello-world-code"></a>

确保可以进行身份验证。

复制并在新的源文件中粘贴以下代码。保存并将文件命名为 `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";
}
```

## 运行程序
<a name="sdk-hello-world-running"></a>

打开命令提示符以运行 PHP 程序。运行 PHP 程序的典型命令语法是：

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

此示例代码不使用任何参数。要运行此代码，请在命令提示符下输入以下内容：

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

## 后续步骤
<a name="sdk-hello-world-next-steps"></a>

要测试更多其他 Amazon S3 操作，请查看 GitHub 上的 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/php/example_code/s3)。