Consentire agli utenti di caricare file

ID regione

Il REGION_ID è un codice abbreviato che Google assegna in base alla regione selezionata durante la creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici di paesi e province di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Quando esegui il caricamento direttamente su Google Cloud Storage, invii un HTTP POST a un URL specifico, che descriveremo tra poco. App Engine utilizza quindi un servizio di caricamento specifico per gestire il post e scrivere il file in Google Cloud Storage. Al termine della scrittura del file, App Engine notifica alla tua app che il caricamento è completato. Poiché l'app viene richiamata solo al termine, puoi utilizzare questo metodo per caricare file molto grandi, fino al massimo attuale di 100 terabyte.

Il caricamento di file da parte degli utenti direttamente su Google Cloud Storage è più veloce ed economico rispetto alla scrittura su Google Cloud Storage dalla tua app App Engine, perché consuma ore di istanza e comporta costi. Inoltre, la scrittura del file non avviene all'interno di una richiesta all'applicazione. Pertanto, è esente dal timeout della richiesta che altrimenti si applicherebbe e consente caricamenti di file molto grandi.

Implementazione dei caricamenti di file

Per implementare il caricamento dei file utente:

  1. Importa CloudStorageTools:

    use google\appengine\api\cloud_storage\CloudStorageTools;

  2. Crea l'URL di caricamento specifico dell'applicazione utilizzando il metodo CloudStorageTools::createUploadUrl() nel file .php nel seguente modo:

    $options = ['gs_bucket_name' => $my_bucket];
$upload_url = CloudStorageTools::createUploadUrl('/upload/handler', $options);

    Per informazioni dettagliate sulle opzioni disponibili, consulta Opzioni createUploadUrl. Tieni presente che my_bucket sarà YOUR_APP_ID. REGION_ID.r.appspot.com se utilizzi il bucket predefinito.

  3. Tieni presente che devi iniziare il caricamento su questo URL entro 10 minuti dalla sua creazione. Inoltre, non puoi modificare l'URL in alcun modo: è firmato e la firma viene controllata prima dell'inizio del caricamento.

  4. Utilizza questo URL come azione per il modulo che utilizzi per accettare i caricamenti, ad esempio:

    <form action="{{ upload_url }}" enctype="multipart/form-data" method="post">
    Files to upload: <br>
   <input type="file" name="uploaded_files" size="40">
   <input type="submit" value="Send">
</form>

Dopo il caricamento dei file, viene inviata una richiesta POST al percorso specificato come primo parametro di createUploadUrl; nell'esempio precedente, questo percorso è /upload_handler.php. Il runtime PHP forma la super globale $_FILES corretta e tmp_filename si riferisce al nome file del file appena caricato in Google Cloud Storage.

Ad esempio, supponiamo che i contenuti di upload_handler.php siano i seguenti:

var_dump($_FILES);

Il caricamento di un file denominato hello.txt potrebbe generare il seguente output:

array(1) {
  ['uploaded_files']=>
  array(5) {
    ['name']=>    string(14) 'hello.txt'
    ['type']=>    string(10) 'text/plain'
    ['tmp_name']=>    string(73) 'gs://my_bucket/L2FwcHMtdXBsb2FkL2Jsb2JzL2IxNUFBVGNJNXNTd0VqR0tFSUtDRGxadGc'
    ['error']=>    int(0)
    ['size']=>    int(1452)
  }
}

Al termine del caricamento, puoi leggere il file caricato utilizzando il wrapper di stream gs://. Utilizzi move_uploaded_file come faresti normalmente per qualsiasi altro file caricato, ad esempio:

$file_name = $_FILES['uploaded_files']['name'];
$temp_name = $_FILES['uploaded_files']['tmp_name'];
move_uploaded_file($temp_name, "gs://${my_bucket}/${file_name}.txt");

Opzioni di createUploadUrl

Le opzioni createUploadUrl valide sono mostrate nella tabella seguente:

Opzione Descrizione
max_bytes_per_blob Numero intero. Valore predefinito: unlimited. Il valore della dimensione massima consentita per un blob caricato.
max_bytes_total Numero intero. Valore predefinito: unlimited. La dimensione totale di tutti i blob caricati.
gs_bucket_name Stringa. Il nome di un bucket Google Cloud Storage in cui caricare i blob. Se non specifichi un valore, il blob viene caricato nel bucket predefinito dell'applicazione.