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

# 安裝第 3 適用於 PHP 的 AWS SDK 版
<a name="getting-started_installation"></a>

您可以安裝第 3 適用於 PHP 的 AWS SDK 版：
+ 透過 Composer 做為相依項目
+ 軟體開發套件預先封裝的 phar
+ 軟體開發套件的 ZIP 檔案

安裝第 3 適用於 PHP 的 AWS SDK 版之前，請確定您的環境使用 PHP 8.1 版或更新版本。進一步了解[環境需求和建議](getting-started_requirements.md)。

**注意**  
透過 .phar 和 .zip 方法安裝 SDK 需要分別安裝和啟用[多位元組字串 PHP 延伸](https://www.php.net/manual/en/book.mbstring.php)。

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

 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';
?>
```

## 使用封裝的 phar 安裝
<a name="installing-by-using-the-packaged-phar"></a>

的每個版本都 適用於 PHP 的 AWS SDK 包含預先封裝的 phar (PHP 封存），其中包含執行 SDK 所需的所有類別和相依性。此外， phar 會自動為 適用於 PHP 的 AWS SDK 及其所有相依性註冊類別自動載入器。

您可以[下載封裝的 phar](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.phar)，並在指令碼中加入此檔案。

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

**注意**  
不建議使用 PHP 搭配 Suhosin 修補程式，但是在 Ubuntu 和 Debian 版本中，這是常見的做法。在這種情況下，您可能需要在 suhosin.ini 中允許使用 phar。若沒有執行此作業，則在您的程式碼中包含 phar 檔案，將會造成無提示的錯誤。若要修改 suhosin.ini，請加入下列程式行。  

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

## 使用 ZIP 檔案安裝
<a name="installing-by-using-the-zip-file"></a>

 適用於 PHP 的 AWS SDK 包含 ZIP 檔案，其中包含執行 SDK 所需的所有類別和相依性。此外，該 ZIP 檔案包含了 適用於 PHP 的 AWS SDK 的類別自動載入函式，以及此函式的相依項目。

若要安裝軟體開發套件，請[下載 .zip 檔案](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.zip)，然後將其解壓縮到您的專案中由您自選的位置。然後，在您的指令碼中加入自動載入函式，如下所示。

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