Lettura e scrittura nei file

Nell'ambiente standard PHP 5 di Google App Engine, il file system locale di cui è stato eseguito il deployment dell'applicazione in non è scrivibile. Questo comportamento garantisce la sicurezza e la scalabilità della tua applicazione.

Tuttavia, se la tua applicazione deve scrivere e leggere file in fase di esecuzione, l'ambiente standard PHP 5 fornisce un wrapper dello stream di Google Cloud Storage integrato che ti consente di utilizzare molte delle funzioni del file system PHP standard per leggere e scrivere file.

Esistono due modi per scrivere file in Google Cloud Storage:

  • Scrivere file dall'app
    • Scrittura di file semplici
    • Scrittura su file trasmessi in streaming
  • Consentire all'utente di caricare file su Google Cloud Storage

Scrittura di file dall'app

Se scrivi file dalla tua app, puoi scrivere l'intero file in una volta sola oppure la scrittura del file in modalità flusso.

Il wrapper flusso App Engine per Cloud Storage è integrato nella runtime e viene utilizzato quando fornisci un nome file che inizia con gs://. Il wrapper richiede che il nome del bucket o dell'oggetto file sia nel formato:

gs://bucket_name/desired_object_name

Scrittura di file semplici

Per scrivere dati in Google Cloud Storage dalla tua app, utilizzi file_put_contents, utilizzando un URL di spazio di archiviazione sul cloud valido. Ad esempio:

file_put_contents("gs://${my_bucket}/hello.txt", $newFileContent);

dove my_bucket è un bucket Google Cloud Storage configurato correttamente.

In alternativa, se vuoi utilizzare le opzioni di stream per fornire autorizzazioni, memorizzazione nella cache e/o opzioni di metadati, puoi scrivere il file come segue:

$options = ['gs' => ['Content-Type' => 'text/plain']];
$context = stream_context_create($options);
file_put_contents("gs://${my_bucket}/hello_options.txt", $newFileContent, 0, $context);

Scrittura su file trasmessi in streaming

In alternativa, puoi utilizzare fopen/fwrite per scrivere dati in un flusso moda:

$fp = fopen("gs://${my_bucket}/hello_stream.txt", 'w');
fwrite($fp, $newFileContent);
fclose($fp);

Tieni presente che quando utilizzi lo streaming, i dati verranno scaricati in Google Cloud Storage in blocchi più piccoli. Non è necessario conoscere in anticipo la lunghezza totale dei dati da scrivere: verrà calcolata al termine della chiusura della risorsa file:

Questi sono i modi di base per scrivere file. Per casi d'uso speciali e più avanzati la gestione di file, consulta gli argomenti elencati in Passaggi successivi.

Eliminazione file in corso...

Se vuoi eliminare il file, utilizza la funzione PHP unlink().

Caricamenti utente

Per maggiori dettagli sull'opzione di scrittura di questo file, vedi Consentire agli utenti di caricare file

Lettura dei file

Per informazioni sulla lettura di file da Google Cloud Storage, vedi Fornire l'accesso pubblico ai file

Configurazione e requisiti

Devi attivare Google Cloud Storage e creare un bucket. Vedi Configurazione. per ulteriori dettagli.

Funzioni del file system PHP 5 supportate

Molte delle funzioni per i file PHP 5 più comunemente utilizzate sono supportate, insieme alle informazioni sui file e alle funzioni di directory. Per un elenco completo delle funzioni PHP supportate, consulta Supporto delle funzioni del file system di PHP 5.

Funzionalità estese fornite dall'API Cloud Storage Tools

Il wrapper dello stream di Google Cloud Storage ti consente di utilizzare le chiamate al file system PHP. Tuttavia, ci sono le funzionalità estese disponibili di cui potresti aver bisogno per un utilizzo ottimale di Google Cloud Storage. Questi le funzionalità estese sono fornite nel API Cloud Storage Tools:

Questa API offre un insieme di funzioni che supportano la pubblicazione di file insieme ad altre utili utilità. Ne illustreremo alcuni nelle altre pagine degli argomenti.

Esiste un altro modo per leggere e scrivere file?

Un'app PHP 5 di App Engine deve utilizzare il wrapper flusso Cloud Storage per scrivere file in fase di runtime. Tuttavia, se un'app deve leggere file e questi sono statici, puoi eventualmente leggere i file statici caricati con l'app utilizzando le funzioni del file system PHP come file_get_contents.

Ad esempio:

$fileContents = file_get_contents($filePath);

dove il percorso specificato deve essere un percorso relativo allo script che vi accede.

Devi caricare il file o i file in una sottodirectory dell'applicazione quando esegui il deployment della tua app su App Engine e devi configurare il file app.yaml in modo che la tua app possa accedervi. Per i dettagli completi, vedi Configurazione dell'applicazione PHP 5 con app.yaml.

Nella configurazione app.yaml, tieni presente che se utilizzi un file statico o un gestore di directory (static_files o static_dir) devi specificare application_readable impostato su true o la tua app non potrà leggere i file. Tuttavia, se i file vengono pubblicati da un gestore script, questo non è necessario. perché, per impostazione predefinita, questi file sono leggibili dai gestori di script.

Passaggi successivi

Leggi i seguenti argomenti per maggiori dettagli sull'utilizzo dell'API Cloud Storage Tools: