View a markdown version of this page

安裝第 3 AWS SDK for PHP 版 - AWS SDK for PHP
透過 Composer 安裝 AWS SDK for PHP 做為相依性使用封裝的 phar 安裝使用 ZIP 檔案安裝

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

安裝第 3 AWS SDK for PHP 版

您可以安裝第 3 AWS SDK for PHP 版：

  • 透過 Composer 做為相依項目

  • 軟體開發套件預先封裝的 phar

  • 軟體開發套件的 ZIP 檔案

安裝第 3 AWS SDK for PHP 版之前，請確定您的環境使用 PHP 8.1 版或更新版本。進一步了解環境需求和建議。

注意

透過 .phar 和 .zip 方法安裝 SDK 需要分別安裝和啟用多位元組字串 PHP 延伸。

透過 Composer 安裝 AWS SDK for PHP 做為相依性

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

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

安裝 Composer

如果 Composer 尚未在您的專案中，請在 Download Composer 頁面上下載並安裝 Composer。

  • 對於 Windows，請遵循 Windows Installer 指示。

  • 對於 Linux，請遵循命令列安裝指示。

透過 Composer 新增 AWS SDK for PHP 做為相依性

如果您的系統已全域安裝 Composer，請在專案的基本目錄中執行下列命令，以安裝 AWS SDK for PHP 做為相依性：

$ composer require aws/aws-sdk-php

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

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

將自動載入函式加入至 php 指令碼

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

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

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

使用封裝的 phar 安裝

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

您可以下載封裝的 phar，並在指令碼中加入此檔案。

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

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

suhosin.executor.include.whitelist = phar

使用 ZIP 檔案安裝

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

若要安裝軟體開發套件，請下載 .zip 檔案，然後將其解壓縮到您的專案中由您自選的位置。然後，在您的指令碼中加入自動載入函式，如下所示。

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