Sommes de contrôle Amazon S3 avec la 3 - AWS SDK for PHP

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Sommes de contrôle Amazon S3 avec la 3

Amazon Simple Storage Service (Amazon S3) permet de spécifier une somme de contrôle lorsque vous chargez un objet. Lorsque vous spécifiez une somme de contrôle, elle est stockée avec l'objet et peut être validée lors du téléchargement de l'objet.

Les checksums fournissent une couche supplémentaire d'intégrité des données lorsque vous transférez des fichiers. Avec les checksums, vous pouvez vérifier la cohérence des données en confirmant que le fichier reçu correspond au fichier d'origine. Pour plus d'informations sur les sommes de contrôle avec Amazon S3, consultez le guide de l'utilisateur d'Amazon Simple Storage Service.

Amazon S3 prend actuellement en charge quatre algorithmes de somme de contrôle : SHA -1, SHA -256, CRC -32 et -32C. CRC Vous avez la possibilité de choisir l'algorithme qui répond le mieux à vos besoins et de le laisser SDK calculer la somme de contrôle. Vous pouvez également spécifier leur propre valeur de somme de contrôle précalculée en utilisant l'un des quatre algorithmes pris en charge.

Nous discutons des sommes de contrôle en deux phases de demande : le téléchargement d'un objet et le téléchargement d'un objet.

Charger un objet

Les valeurs valides pour l'algorithme sont CRC32CRC32C,SHA1, etSHA256.

L'extrait de code suivant montre une demande de téléchargement d'un objet avec une somme de contrôle de CRC -32. Lorsque le SDK envoie la demande, il calcule la somme de contrôle CRC -32 et télécharge l'objet. Amazon S3 stocke le checksum avec l'objet.

Si la somme de contrôle SDK calculée ne correspond pas à la somme de contrôle calculée par Amazon S3 lorsqu'il reçoit la demande, une erreur est renvoyée.

Utiliser une valeur de somme de contrôle précalculée

Une valeur de somme de contrôle précalculée fournie avec la demande désactive le calcul automatique par le SDK et utilise la valeur fournie à la place.

L'exemple suivant montre une demande avec une somme de contrôle pré-calculée de SHA -256.

Si Amazon S3 détermine que la valeur de la somme de contrôle est incorrecte pour l'algorithme spécifié, le service renvoie une réponse d'erreur.

Chargements partitionnés

Vous pouvez également utiliser des checksums pour les téléchargements partitionnés.

Télécharger un objet

Lorsque vous utilisez getObjectcette méthode pour télécharger un objet, la somme de contrôle valide SDK automatiquement . enabled

La demande contenue dans l'extrait suivant demande SDK à la personne de valider la somme de contrôle dans la réponse en calculant la somme de contrôle et en comparant les valeurs.

Si l'objet n'a pas été chargé avec une somme de contrôle, aucune validation n'a lieu.

Un objet dans Amazon S3 peut avoir plusieurs checksum, mais un seul checksum est validé lors du téléchargement. La priorité suivante, basée sur l'efficacité de l'algorithme de somme de contrôle, détermine la somme de contrôle à valider : SDK

  1. CRC-32 °C

  2. CRC-32

  3. SHA-1

  4. SHA-256

Par exemple, si une réponse contient à la fois des sommes de contrôle CRC -32 et SHA -256, seule la somme de contrôle de CRC -32 est validée.