使用 S3 配置適用於 PHP 的 AWS 開發工具包

Amazon Web Services (AWS) 是一個強大的平台，為開發人員和企業提供廣泛的服務。在這些服務中，Amazon Simple Storage Service (S3) 是最受歡迎且使用最廣泛的服務之一。若要以程式設計方式與 S3 交互，您可以使用適用於 PHP 的 AWS 開發工具包。在本文中，我們將引導您完成使用 S3 配置適用於 PHP 的 AWS 開發工具包的過程。

先決條件

在我們開始之前，請確保您具備以下條件：

• AWS 帳號
• AWS 存取金鑰 ID 與秘密存取金鑰
• PHP 5.6 或更高版本
• 已安裝作曲家

安裝

要安裝適用於 PHP 的 AWS 開發工具包，您可以使用 Composer。在終端機中執行以下命令：

composer require aws/aws-sdk-php

此命令將在您的專案中安裝最新版本的適用於 PHP 的 AWS 開發工具包。

配置

安裝 SDK 後，您需要使用您的 AWS 存取金鑰 ID 和秘密存取金鑰對其進行配置。您可以透過建立設定檔或設定環境變數來完成此操作。

設定檔

在專案中建立一個名為 config.php 的新檔案並新增以下程式碼：

<?php
require 'vendor/autoload.php';

use Aws\Sdk;

$sdk = new Sdk([
    'region' => 'us-east-1',
    'version' => 'latest',
    'credentials' => [
        'key' => 'YOUR_ACCESS_KEY_ID',
        'secret' => 'YOUR_SECRET_ACCESS_KEY',
    ]
]);

$s3Client = $sdk->createS3();

將 YOUR_ACCESS_KEY_ID 和 YOUR_SECRET_ACCESS_KEY 替換為您的實際 AWS 存取金鑰 ID 和秘密存取金鑰。

環境變數

或者，您可以將 AWS 存取金鑰 ID 和秘密存取金鑰設定為環境變數：

export AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY_ID
export AWS_SECRET_ACCESS_KEY=YOUR_SECRET_ACCESS_KEY

然後，建立 S3 用戶端，如下所示：

<?php
require 'vendor/autoload.php';

use Aws\Sdk;

$sdk = new Sdk([
    'region' => 'us-east-1',
    'version' => 'latest',
]);

$s3Client = $sdk->createS3();

準備好了解更多關於 AWS 和 PHP 的資訊了嗎？請參閱我們關於 AWS 設定 SSO 和修復 laravel 權限被拒絕錯誤的其他文章。

用法

現在您已經使用 S3 配置了適用於 PHP 的 AWS 開發工具包，您可以開始使用它與 S3 儲存桶進行互動。以下是如何列出帳戶中所有儲存桶的範例：

$buckets = $s3Client->listBuckets();
foreach ($buckets['Buckets'] as $bucket) {
    echo $bucket['Name'] . PHP_EOL;
}

當然，這裡有一些將適用於 PHP 的 AWS 開發工具包與 S3 結合使用的其他範例和最佳實踐。

上傳文件

要將檔案上傳到 S3 儲存桶，您可以使用 putObject 方法。這是一個例子：

$bucketName = 'my-bucket';
$keyName = 'my-file.txt';
$filePath = '/path/to/my-file.txt';

$result = $s3Client->putObject([
    'Bucket' => $bucketName,
    'Key' => $keyName,
    'SourceFile' => $filePath,
]);

echo $result['ObjectURL'] . PHP_EOL;

此程式碼會將位於 /path/to/my-file.txt 的檔案上傳到 my-bucket 儲存桶，並列印上傳檔案的 URL。

下載文件

要從 S3 儲存桶下載文件，您可以使用 getObject 方法。這是一個例子：

$bucketName = 'my-bucket';
$keyName = 'my-file.txt';
$filePath = '/path/to/downloaded-file.txt';

$result = $s3Client->getObject([
    'Bucket' => $bucketName,
    'Key' => $keyName,
    'SaveAs' => $filePath,
]);

echo $result['ContentLength'] . ' bytes downloaded.' . PHP_EOL;

此程式碼將從 my-bucket 儲存桶下載帶有 my-file.txt 金鑰的檔案並將其儲存到 /path/to/downloaded-file.txt。

列出對象

要列出 S3 儲存桶中的對象，您可以使用 listObjects 方法。這是一個例子：

$bucketName = 'my-bucket';

$result = $s3Client->listObjects([
    'Bucket' => $bucketName,
]);

foreach ($result['Contents'] as $object) {
    echo $object['Key'] . PHP_EOL;
}

此程式碼將列出 my-bucket 儲存桶中的所有物件並列印它們的金鑰。

最佳實務 - AWS SDK + PHP + S3

以下是將適用於 PHP 的 AWS 開發工具包與 S3 結合使用時需要記住的一些最佳實踐：

• 使用 IAM 角色和策略來管理對 S3 資源的存取。
• 使用版本控制來保留物件的多個版本並防止意外刪除。
• 使用生命週期策略自動管理物件的儲存和保留。
• 使用傳輸加速來提高上傳和下載的效能。
• 使用伺服器端加密來保護您的靜態資料。
• 使用事件通知根據 S3 物件的變更觸發操作。

當然，這裡有一些有關在 Laravel 中將適用於 PHP 的 AWS 開發工具包與 S3 結合使用的其他提示。

將適用於 PHP 的 AWS 開發工具包與 Laravel 結合使用

Laravel 內建了對 AWS SDK for PHP 的支持，這使得您可以在 Laravel 應用程式中輕鬆使用 S3。以下是 Laravel 中使用 SDK 的一些技巧：

• 透過 Composer 安裝適用於 PHP 的 AWS 開發工具包：

composer require aws/aws-sdk-php

• 在 .env 檔案中配置您的 AWS 憑證：

AWS_ACCESS_KEY_ID=your_access_key_id
AWS_SECRET_ACCESS_KEY=your_secret_access_key
AWS_DEFAULT_REGION=your_region

• 使用 Storage Facade 與 S3 互動：

use Illuminate\Support\Facades\Storage;

// Upload a file
Storage::disk('s3')->put('my-file.txt', file_get_contents('/path/to/my-file.txt'));

// Download a file
Storage::disk('s3')->download('my-file.txt', '/path/to/downloaded-file.txt');

// List the objects in a bucket
$objects = Storage::disk('s3')->listContents('my-bucket');

foreach ($objects as $object) {
    echo $object['path'] . PHP_EOL;
}

• 使用 Laravel 的 Flysystem 適配器來自訂 Storage Facade 的行為：

use Illuminate\Support\ServiceProvider;
use League\Flysystem\AwsS3V3\AwsS3V3Adapter;
use Aws\S3\S3Client;

class S3ServiceProvider extends ServiceProvider
{
    public function register()
    {
        $this->app->singleton('filesystems.disks.s3', function ($app) {
            return new AwsS3V3Adapter(
                new S3Client([
                    'region' => config('filesystems.disks.s3.region'),
                    'version' => 'latest',
                    'credentials' => [
                        'key' => config('filesystems.disks.s3.key'),
                        'secret' => config('filesystems.disks.s3.secret'),
                    ],
                ]),
                config('filesystems.disks.s3.bucket')
            );
        });
    }
}

• 使用Laravel的佇列系統非同步執行S3操作：

use Illuminate\Support\Facades\Storage;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;

class UploadFile implements ShouldQueue
{
    use InteractsWithQueue;

    protected $filePath;

    public function __construct($filePath)
    {
        $this->filePath = $filePath;
    }

    public function handle()
    {
        Storage::disk('s3')->put('my-file.txt', file_get_contents($this->filePath));
    }
}

最佳實務 - AWS SDK + PHP + Laravel

以下是在 Laravel 中將適用於 PHP 的 AWS 開發工具包與 S3 結合使用時需要記住的一些最佳實踐：

• 使用 Laravel 對適用於 PHP 的 AWS 開發工具包的內建支援來簡化您的程式碼並減少需要編寫的樣板程式碼量。
• 使用 Laravel 的佇列系統非同步執行 S3 操作，這可以提高 Laravel 應用程式的效能和可擴展性。
• 使用 Laravel 的 Flysystem 適配器自訂 Storage Facade 的行為，並將 S3 與其他 Laravel 功能集成，例如 Laravel 的快取系統。
• 使用 Laravel 的佇列系統非同步執行 S3 操作，這可以提高 Laravel 應用程式的效能和可擴展性。
• 使用 Laravel 的加密功能對敏感資料進行加密，然後再儲存在 S3 中。
• 使用 Laravel 的日誌記錄功能來記錄在 S3 中使用適用於 PHP 的 AWS 開發工具包時發生的任何錯誤或異常。

結論

在本文中，我們介紹了使用 S3 配置適用於 PHP 的 AWS 開發工具包的基礎知識，並提供了一些使用該開發工具包與 S3 的其他範例和最佳實踐。我們還提供了一些在 Laravel 中將 SDK 與 S3 結合使用的額外提示。透過遵循這些準則，您可以確保您的 PHP 應用程式安全、高效且可擴展。

---

想要了解更多關於 AWS 和 PHP 的資訊？查看我們關於 DevOps Mind 的其他文章。

以上是使用 S3 配置適用於 PHP 的 AWS 開發工具包的詳細內容。更多資訊請關注PHP中文網其他相關文章！