Configuration du SDK AWS pour PHP avec S3

Amazon Web Services (AWS) est une plateforme puissante qui offre une large gamme de services aux développeurs et aux entreprises. Parmi ces services, Amazon Simple Storage Service (S3) est l'un des plus populaires et des plus utilisés. Pour interagir avec S3 par programmation, vous pouvez utiliser le kit AWS SDK pour PHP. Dans cet article, nous vous guiderons tout au long du processus de configuration du SDK AWS pour PHP avec S3.

Conditions préalables

Avant de commencer, assurez-vous d'avoir les éléments suivants :

• Un compte AWS
• ID de clé d'accès AWS et clé d'accès secrète
• PHP 5.6 ou supérieur
• Compositeur installé

Installation

Pour installer le SDK AWS pour PHP, vous pouvez utiliser Composer. Exécutez la commande suivante dans votre terminal :

composer require aws/aws-sdk-php

Cette commande installera la dernière version du kit AWS SDK pour PHP dans votre projet.

Configuration

Une fois que vous avez installé le SDK, vous devez le configurer avec votre ID de clé d'accès AWS et votre clé d'accès secrète. Vous pouvez le faire en créant un fichier de configuration ou en définissant des variables d'environnement.

Fichier de configuration

Créez un nouveau fichier nommé config.php dans votre projet et ajoutez le code suivant :

<?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();

Remplacez YOUR_ACCESS_KEY_ID et YOUR_SECRET_ACCESS_KEY par votre ID de clé d'accès AWS et votre clé d'accès secrète actuels.

Variables d'environnement

Vous pouvez également définir l'ID de clé d'accès AWS et la clé d'accès secrète comme variables d'environnement :

export AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY_ID
export AWS_SECRET_ACCESS_KEY=YOUR_SECRET_ACCESS_KEY

Ensuite, créez le client S3 comme suit :

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

use Aws\Sdk;

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

$s3Client = $sdk->createS3();

Prêt à en savoir plus sur AWS et PHP ? Consultez nos autres articles sur AWS configure SSO et Correction des erreurs d'autorisation Laravel refusées.

Usage

Maintenant que vous avez configuré le SDK AWS pour PHP avec S3, vous pouvez commencer à l'utiliser pour interagir avec vos compartiments S3. Voici un exemple de la façon de répertorier tous les compartiments de votre compte :

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

Bien sûr, voici quelques exemples supplémentaires et bonnes pratiques pour l'utilisation du kit AWS SDK pour PHP avec S3.

Télécharger un fichier

Pour télécharger un fichier dans un bucket S3, vous pouvez utiliser la méthode putObject. Voici un exemple :

$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;

Ce code téléchargera le fichier situé dans /path/to/my-file.txt dans le bucket my-bucket et imprimera l'URL du fichier téléchargé.

Télécharger un fichier

Pour télécharger un fichier depuis un bucket S3, vous pouvez utiliser la méthode getObject. Voici un exemple :

$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;

Ce code téléchargera le fichier avec la clé my-file.txt depuis le bucket my-bucket et l'enregistrera dans /path/to/downloaded-file.txt.

Liste des objets

Pour lister les objets dans un bucket S3, vous pouvez utiliser la méthode listObjects. Voici un exemple :

$bucketName = 'my-bucket';

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

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

Ce code listera tous les objets du bucket my-bucket et imprimera leurs clés.

Meilleures pratiques – AWS SDK + PHP + S3

Voici quelques bonnes pratiques à garder à l'esprit lors de l'utilisation du kit AWS SDK pour PHP avec S3 :

• Utilisez les rôles et les stratégies IAM pour gérer l'accès à vos ressources S3.
• Utilisez le contrôle de version pour conserver plusieurs versions de vos objets et vous protéger contre toute suppression accidentelle.
• Utilisez des politiques de cycle de vie pour gérer automatiquement le stockage et la conservation de vos objets.
• Utilisez l'accélération des transferts pour améliorer les performances de vos chargements et téléchargements.
• Utilisez le cryptage côté serveur pour protéger vos données au repos.
• Utilisez les notifications d'événements pour déclencher des actions en fonction des modifications apportées à vos objets S3.

Bien sûr, voici quelques conseils supplémentaires pour utiliser le SDK AWS pour PHP avec S3 dans Laravel.

Utilisation du SDK AWS pour PHP avec Laravel

Laravel prend en charge le kit AWS SDK pour PHP, ce qui facilite l'utilisation de S3 dans vos applications Laravel. Voici quelques conseils pour utiliser le SDK avec Laravel :

• Installez le package AWS SDK pour PHP via Composer :

composer require aws/aws-sdk-php

• Configurez vos informations d'identification AWS dans votre fichier .env :

AWS_ACCESS_KEY_ID=your_access_key_id
AWS_SECRET_ACCESS_KEY=your_secret_access_key
AWS_DEFAULT_REGION=your_region

• Utilisez la façade Storage pour interagir avec 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;
}

• Utilisez l'adaptateur Flysystem de Laravel pour personnaliser le comportement de la façade Storage :

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')
            );
        });
    }
}

• Utilisez le système de file d'attente de Laravel pour effectuer des opérations S3 de manière asynchrone :

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));
    }
}

Meilleures pratiques – AWS SDK + PHP + Laravel

Voici quelques bonnes pratiques à garder à l'esprit lors de l'utilisation du kit SDK AWS pour PHP avec S3 dans Laravel :

• Utilisez la prise en charge intégrée de Laravel pour le kit SDK AWS pour PHP pour simplifier votre code et réduire la quantité de code passe-partout que vous devez écrire.
• Utilisez le système de file d'attente de Laravel pour effectuer des opérations S3 de manière asynchrone, ce qui peut améliorer les performances et l'évolutivité de vos applications Laravel.
• Utilisez l'adaptateur Flysystem de Laravel pour personnaliser le comportement de la façade de stockage et intégrer S3 à d'autres fonctionnalités de Laravel, telles que le système de cache de Laravel.
• Utilisez le système de file d'attente de Laravel pour effectuer des opérations S3 de manière asynchrone, ce qui peut améliorer les performances et l'évolutivité de vos applications Laravel.
• Utilisez les fonctionnalités de cryptage de Laravel pour crypter les données sensibles avant de les stocker dans S3.
• Utilisez les fonctionnalités de journalisation de Laravel pour enregistrer toutes les erreurs ou exceptions qui se produisent lors de l'utilisation du kit AWS SDK pour PHP avec S3.

Conclusion

Dans cet article, nous avons couvert les bases de la configuration du SDK AWS pour PHP avec S3 et fourni quelques exemples supplémentaires et bonnes pratiques pour l'utilisation du SDK avec S3. Nous avons également fourni quelques conseils supplémentaires pour utiliser le SDK avec S3 dans Laravel. En suivant ces directives, vous pouvez vous assurer que vos applications PHP sont sécurisées, efficaces et évolutives.

---

Vous voulez en savoir plus sur AWS et PHP ? Consultez nos autres articles sur DevOps Mind.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!