- AWS SDK for PHP

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3) offre la possibilità di specificare un checksum quando carichi un oggetto. Quando specifichi un checksum, questo viene memorizzato con l'oggetto e può essere convalidato quando l'oggetto viene scaricato.

I checksum forniscono un ulteriore livello di integrità dei dati durante il trasferimento dei file. Con i checksum, è possibile verificare la coerenza dei dati confermando che il file ricevuto corrisponde al file originale. Per ulteriori informazioni sui checksum con Amazon S3, consulta la Amazon Simple Storage Service User Guide.

Amazon S3 attualmente supporta quattro algoritmi di checksum: SHA-1, SHA-256, CRC-32 e CRC-32C. Hai la flessibilità di scegliere l'algoritmo più adatto alle tue esigenze e lasciare che sia l'SDK a calcolare il checksum. In alternativa, puoi specificare il proprio valore di checksum precalcolato utilizzando uno dei quattro algoritmi supportati.

Discutiamo i checksum in due fasi di richiesta: caricamento di un oggetto e download di un oggetto.

Caricamento di un oggetto

I valori validi per l'algoritmo sonoCRC32,CRC32C, SHA1 e. SHA256

Il seguente frammento di codice mostra una richiesta di caricamento di un oggetto con un checksum CRC-32. Quando l'SDK invia la richiesta, calcola il checksum CRC-32 e carica l'oggetto. Amazon S3 memorizza il checksum con l'oggetto.

Se il checksum calcolato dall'SDK non corrisponde al checksum calcolato da Amazon S3 quando riceve la richiesta, viene restituito un errore.

Utilizza un valore di checksum precalcolato

Un valore di checksum precalcolato fornito con la richiesta disabilita il calcolo automatico da parte dell'SDK e utilizza invece il valore fornito.

L'esempio seguente mostra una richiesta con un checksum SHA-256 precalcolato.

Se Amazon S3 determina che il valore del checksum non è corretto per l'algoritmo specificato, il servizio restituisce una risposta di errore.

Caricamenti in più parti

Puoi anche utilizzare i checksum con caricamenti in più parti.

Donwload di un oggetto

Quando utilizzate il metodo getObject per scaricare un oggetto, l'SDK convalida automaticamente il checksum . enabled

La richiesta nel seguente frammento indica all'SDK di convalidare il checksum nella risposta calcolando il checksum e confrontando i valori.

Se l'oggetto non è stato caricato con un checksum, non viene effettuata alcuna convalida.

Un oggetto in Amazon S3 può avere più checksum, ma al download viene convalidato solo un checksum. La seguente precedenza, basata sull'efficienza dell'algoritmo di checksum, determina quale checksum viene convalidato dall'SDK:

  1. CRC-32C

  2. CRC-32

  3. SHA-1

  4. SHA-256

Ad esempio, se una risposta contiene entrambi i checksum CRC-32 e SHA-256, viene convalidato solo il checksum CRC-32.