Zuletzt aktualisiert: 11. September

Dateien mit PHP nach Amazon S3 exportieren: umfassender Leitfaden

Tim Koschützki

Mitgründer · Berlin, Deutschland ·

Amazon S3 ist ein hochgradig skalierbarer und beständiger Cloud-Speicherdienst, der Ihre PHP-Anwendungen durch effiziente Funktionen für den Dateiexport deutlich aufwerten kann. Ob Sie Uploads von Nutzern, Backups oder die Auslieferung von Medieninhalten abwickeln: Die Integration von Amazon S3 in Ihre PHP-Projekte sorgt für zuverlässige und sichere Speicherung. In diesem umfassenden Leitfaden führen wir Sie durch den Dateiexport nach Amazon S3 mit PHP und behandeln dabei alles von der Einrichtung bis hin zu fortgeschrittenen Techniken für große Dateiexporte.

Voraussetzungen und Einrichtung

Bevor wir beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

Eine unterstützte PHP-Version, die mit dem installierten AWS SDK kompatibel ist
Composer installiert
Ein AWS-Konto mit Zugriff auf Amazon S3
AWS SDK für PHP

AWS SDK für PHP installieren

Erstellen Sie zunächst eine Datei composer.json mit der folgenden Konfiguration:

{
  "require": {
    "aws/aws-sdk-php": "^3.0"
  }
}

Installieren Sie anschließend das AWS SDK mit Composer:

composer install

AWS-Zugangsdaten konfigurieren

Verwenden Sie in Entwicklungsumgebungen Umgebungsvariablen (empfohlen):

export AWS_ACCESS_KEY_ID=YOUR_AWS_ACCESS_KEY_ID
export AWS_SECRET_ACCESS_KEY=YOUR_AWS_SECRET_ACCESS_KEY
export AWS_DEFAULT_REGION=your-region

Verwenden Sie in Produktionsumgebungen nach Möglichkeit IAM-Rollen, insbesondere bei AWS-Diensten wie EC2, ECS oder Lambda.

Einen einfachen S3-Bucket erstellen

Beachten Sie beim Erstellen eines S3-Buckets diese wichtigen Richtlinien:

Bucket-Namen müssen über alle AWS-Konten hinweg global eindeutig sein.
Namen sollten zwischen 3 und 63 Zeichen lang sein.
Verwenden Sie ausschließlich Kleinbuchstaben, Zahlen, Punkte und Bindestriche.
Namen müssen mit einem Buchstaben oder einer Zahl beginnen und enden.

Erstellen Sie einen Bucket mit der AWS CLI:

aws s3api create-bucket \
    --bucket your-bucket-name \
    --region your-region \
    --create-bucket-configuration LocationConstraint=your-region

Lassen Sie bei us-east-1 die Option --create-bucket-configuration weg; es wird der Standardspeicherort verwendet. Aktivieren Sie anschließend die empfohlenen Sicherheitseinstellungen:

# Disable acls by enforcing bucket ownership controls
aws s3api put-bucket-ownership-controls \
    --bucket your-bucket-name \
    --ownership-controls 'Rules=[{ObjectOwnership=BucketOwnerEnforced}]'

# Block public access
aws s3api put-public-access-block \
    --bucket your-bucket-name \
    --public-access-block-configuration \
    BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true

Ein PHP-Skript zum Dateiexport entwickeln

Nachfolgend finden Sie ein einfaches Beispiel für das Hochladen einer Datei nach S3:

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

use Aws\S3\S3Client;
use Aws\Exception\AwsException;

try {
    $s3Client = new S3Client([
        'version' => 'latest',
        'region'  => getenv('AWS_DEFAULT_REGION'),
    ]);

    $bucket = 'your-bucket-name';
    $key = 'path/to/destination/file.txt';
    $sourceFile = '/path/to/local/file.txt';

    $result = $s3Client->putObject([
        'Bucket' => $bucket,
        'Key'    => $key,
        'SourceFile' => $sourceFile,
        'ContentType' => mime_content_type($sourceFile),
    ]);

    echo "File uploaded successfully. Location: {$result['ObjectURL']}\n";
} catch (AwsException $e) {
    echo "Error: {$e->getMessage()}\n";
    echo "AWS Error Code: {$e->getAwsErrorCode()}\n";
    echo "Request ID: {$e->getAwsRequestId()}\n";
}

Datei-Metadaten effizient verarbeiten

Beim Hochladen von Dateien können Sie Metadaten mitgeben und serverseitige Verschlüsselung anwenden:

$result = $s3Client->putObject([
    'Bucket' => $bucket,
    'Key'    => $key,
    'SourceFile' => $sourceFile,
    'ContentType' => mime_content_type($sourceFile),
    'Metadata' => [
        'original-filename' => basename($sourceFile),
        'upload-date' => date('c'),
    ],
    'ServerSideEncryption' => 'AES256',
    'CacheControl' => 'max-age=86400',
]);

Ihre Integration testen und debuggen

Installieren Sie Monolog, bevor Sie dieses Logging-Beispiel verwenden:

composer require monolog/monolog

Richten Sie das Verzeichnis /var/log/my-app außerhalb des Web-Roots ein, beschreibbar nur durch den Anwendungsbenutzer und Administratoren. Passen Sie den Pfad an Ihr Deployment an:

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Aws\S3\Exception\S3Exception;

$logger = new Logger('s3-uploads');
$logger->pushHandler(new StreamHandler('/var/log/my-app/s3-uploads.log', Logger::DEBUG));

try {
    $result = $s3Client->putObject([
        'Bucket' => $bucket,
        'Key'    => $key,
        'SourceFile' => $sourceFile,
    ]);
    $logger->info('File uploaded successfully', [
        'bucket' => $bucket,
        'key' => $key,
        'location' => $result['ObjectURL'],
    ]);
} catch (S3Exception $e) {
    $logger->error('S3 upload failed', [
        'error' => $e->getMessage(),
        'code' => $e->getAwsErrorCode(),
        'request_id' => $e->getAwsRequestId(),
    ]);
    throw $e;
}

Fortgeschrittene Anwendungsfälle: Multipart-Uploads

Verwenden Sie für Dateien, die größer als 100 MB sind, die Klasse MultipartUploader:

use Aws\S3\MultipartUploader;
use Aws\Exception\MultipartUploadException;

try {
    $uploader = new MultipartUploader($s3Client, $sourceFile, [
        'bucket' => $bucket,
        'key'    => $key,
        'params' => [
            'ContentType' => mime_content_type($sourceFile),
        ],
    ]);

    $result = $uploader->upload();
    echo "Upload complete: {$result['ObjectURL']}\n";
} catch (MultipartUploadException $e) {
    echo "Multipart upload error: {$e->getMessage()}\n";
}

Bewährte Verfahren für die Sicherheit

Befolgen Sie diese bewährten Verfahren, um Ihre S3-Integration für den Dateiexport abzusichern:

IAM-Rollen und -Richtlinien verwenden: Vergeben Sie mithilfe von IAM-Rollen nur die minimal erforderlichen Berechtigungen und bevorzugen Sie nach Möglichkeit temporäre Zugangsdaten.
Serverseitige Verschlüsselung aktivieren: Verwenden Sie von AWS verwaltete Schlüssel (SSE-S3) oder kundenverwaltete Schlüssel (SSE-KMS) und erwägen Sie, die Standardverschlüsselung für Ihren Bucket zu aktivieren.
Angemessene Zugriffskontrollen umsetzen: Beschränken Sie den Zugriff mit Bucket-Richtlinien, deaktivieren Sie Legacy-ACLs, indem Sie Bucket-Ownership-Controls erzwingen, und blockieren Sie den öffentlichen Zugriff sowohl auf Bucket- als auch auf Kontoebene.
Aktivitäten überwachen und auditieren: Aktivieren Sie das S3-Zugriffs-Logging, verfolgen Sie API-Aufrufe mit AWS CloudTrail und konfigurieren Sie CloudWatch-Alarme für verdächtiges Verhalten.
Überprüfen Sie Ihre Bucket-Richtlinien, Speicherklassen und Lifecycle-Einstellungen, um Kosten zu optimieren und Daten effektiv zu verwalten.

Häufige Probleme beheben

Wenn beim Dateiexport Probleme auftreten, ziehen Sie die folgenden Schritte zur Fehlerbehebung in Betracht:

Prüfen Sie, ob Ihre AWS-Zugangsdaten und Regionseinstellungen korrekt sind.
Stellen Sie sicher, dass der Bucket-Name den AWS-Namensregeln entspricht.
Vergewissern Sie sich, dass Ihr S3-Bucket mit passenden Zugriffsrichtlinien und Ownership-Einstellungen konfiguriert ist.
Kontrollieren Sie, ob lokale Dateipfade und Berechtigungen korrekt sind.
Sehen Sie sich die AWS-SDK-Logs auf detaillierte Fehlermeldungen an.

Fazit und nächste Schritte

Mit diesem Leitfaden haben Sie Funktionen für den Dateiexport nach Amazon S3 in Ihre PHP-Anwendungen integriert und dabei die aktuellen bewährten Verfahren des AWS SDK genutzt. Erkunden Sie weiterhin die AWS-Dokumentation und die SDK-Funktionen, um Ihre Integration weiter zu verbessern und Ihre Dateiübertragungen abzusichern.

Für weitere Perspektiven auf fortgeschrittenes Hochladen von Dateien können Sie auch andere verfügbare Lösungen erkunden.

Viel Spaß beim Programmieren!