Gestione avanzata dei file PHP 5

Questa API è supportata per runtime di prima generazione e può essere utilizzata quando eseguire l'upgrade ai runtime di seconda generazione corrispondenti. Se esegui l'aggiornamento ad App Engine 8/7 PHP runtime, consulta guida alla migrazione per saperne di più sulle opzioni di migrazione per i servizi in bundle legacy.

Autorizzazioni, memorizzazione nella cache e opzioni dei metadati

Il wrapper stream App Engine per Cloud Storage fornisce quanto segue opzioni per configurare lo stream:

Opzione	Valori possibili	Descrizione
acl	Uno dei seguenti valori: private public-read public-read-write authenticated-read bucket-owner-read bucket-owner-full-control privato-progetto	Per descrizioni di cosa fanno queste impostazioni in Cloud Storage, vedi ACL predefiniti. Se non imposti acl, Cloud Storage imposta questo parametro come nullo e utilizza l'ACL dell'oggetto predefinito associato al bucket che contiene il file.
Content-Type	Qualsiasi tipo MIME valido	Se non specifichi un tipo di contenuto quando carichi un oggetto, il sistema Google Cloud Storage utilizzerà per impostazione predefinita binary/octet-stream quando pubblica l'oggetto.
Content-Disposition	Qualsiasi valore valido per content-disposition	Un'intestazione che puoi impostare su un oggetto per specificare informazioni di presentazione su come devono essere trasmessi i dati dell'oggetto.
Content-Encoding	Qualsiasi algoritmo di compressione valido	L'algoritmo di compressione dell'oggetto, ad esempio gzip. Tieni presente che Google Cloud Storage non comprime o decomprime automaticamente gli oggetti in base a questa intestazione.
Content-Language	Qualsiasi codice lingua ISO 639-1 valido	Il codice lingua ISO 639-1 dei contenuti (per un elenco completo, consulta Codici per la rappresentazione dei nomi delle lingue).
enable_cache	true o false (true per impostazione predefinita)	I file letti da Cloud Storage vengono memorizzati nella cache in memoria (vedi memcache) per migliorare le prestazioni. La memorizzazione nella cache può essere disattivata utilizzando l'istruzione enable_cache nel contesto dello stream.
enable_optimistic_cache	true o false (falso per impostazione predefinita)	Puoi attivare la memorizzazione nella cache ottimistica per leggere l'oggetto file dalla cache senza verificare se l'oggetto sottostante è stato modificato in Cloud Storage dall'ultima volta che è stato memorizzato nella cache. La memorizzazione nella cache ottimistica è ideale per scenari di tipo write-once e read-many.
metadata	Un array associativo, ad esempio	['foo' => 'far', 'bar' => 'boo'] Consulta Lettura e scrittura di metadati personalizzati.
read_cache_expiry_seconds	Il numero di secondi durante i quali un oggetto rimarrà valido nella cache	Puoi modificare il periodo di tempo durante il quale un oggetto memorizzato nella cache rimane valido utilizzando l'read_cache_expiry_seconds directive. Questo specifica il momento dopo il quale l'oggetto verrà ricaricato al successivo tentativo di lettura. Per impostazione predefinita, l'intervallo è 1 ora (3600).
writable_cache_expiry_seconds	Il numero di secondi in cui lo stato scrivibile di un bucket viene memorizzato nella cache	Il wrapper dello stream Cloud Storage memorizza nella cache lo stato di scrittura dei bucket per migliorare le prestazioni. Ciò significa che i bit scrivibili restituiti da varie funzioni correlate alle stat() possono essere temporaneamente non sincronizzati quando l'ACL del bucket cambia. Il valore predefinito è 10 minuti (600).

Il seguente snippet mostra come utilizzare le opzioni di stream:

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

Nello snippet precedente, $options è un insieme di argomenti che verrà utilizzato dallo stream durante la scrittura di nuovi oggetti, che possono essere impostati come opzioni predefinite utilizzando stream_context_set_default

Supporto delle funzioni del filesystem PHP 5 su Cloud Storage

Il wrapper dello stream di App Engine per Cloud Storage supporta molte funzioni del file system PHP native. Alcune funzioni non sono supportate, mentre altre sono state modificate assistenza. La tabella seguente elenca ciascuna di queste funzioni native, indicando se è supportata o meno. Se una funzione è supportata, ma con modifiche o limitazioni, descritte.

Funzione file system	Supportato?	Dettagli
basename: restituisce il componente del nome finale del percorso.	Supportato.
chgrp: modifica il gruppo di file.	Non supportati.	Restituisce sempre false.
chmod: modifica il modo del file.	Non supportati.	Restituisce sempre false.
chown: modifica il proprietario del file.	Non supportati.	Restituisce sempre false.
clearstatcache: svuota la cache dello stato del file.	Supportato.
copy: copia il file.	Supportato.
dirname: restituisce il percorso della directory principale.	Supportata.	Supportato, ma include il prefisso gs://.
disk_free_space: restituisce lo spazio disponibile sul file system o su una partizione del disco.	Non supportati.	Questa opzione è Disattivata.
disk_total_space: restituisce la dimensione totale di un file system o di una partizione del disco.	Non supportati.	Questa opzione è disattivata.
diskfreespace: alias di disk_free_space.
fclose: chiude il puntatore di un file aperto.	Supportata.
feof: verifica la presenza di un indicatore di fine file in un puntatore a file.	Supportato.
fflush: svuota l'output in un file.	Supportato.	Non ha alcun effetto. (restituisce sempre true).
fgetc: recupera il carattere dal puntatore del file.	Supportato.
fgetcsv: ottiene una riga dal puntatore del file e analizza i campi CSV.	Supportata.
fgets: recupera la riga dal puntatore del file.	Supportato.
fgetss: ottiene una riga dal puntatore del file e rimuove i tag HTML.	Supportata.
file_exists: verifica se esiste un file o una directory.	Supportata.
file_get_contents: legge l'intero file in una stringa.	Supportata.
file_put_contents: scrive una stringa in un file.	Supportata.
file: legge l'intero file in un array.	Supportato.
fileatime: recupera l'ora dell'ultimo accesso al file.	Non supportati.	Restituisce sempre 0.
filectime: recupera l'ora della modifica dell'inode del file.	Non supportati.	Restituisce sempre 0.
filegroup: ottiene il gruppo di file.	Non supportati.	Restituisce sempre 0.
fileinode: ottiene il file inode.	Non supportati.	Restituisce sempre 0.
filemtime: recupera la data e l'ora di modifica del file.	Supportata.
fileowner: ottiene il proprietario del file.	Non supportati.	Restituisce sempre 0.
fileperms: recupera le autorizzazioni dei file.	Supportato.	Il bit di esecuzione è sempre disattivato.
filesize: recupera le dimensioni del file.	Supportato.
filetype: recupera il tipo di file.	Supportata.
flock: blocco dei file di avviso portabile.	Non supportato.	Restituisce sempre false.
fopen: apre il file o l'URL.	Supportata.	Supporta solo queste modalità: r, rb, rt, w, wb, wt.
fpassthru: esporta tutti i dati rimanenti in un puntatore file.	Supportata.
fputcsv: formatta la riga come CSV e scrivi nel puntatore del file.	Supportato.
fputs: alias di fwrite.
fread: lettura di un file sicuro per i file binari.	Supportato.
fscanf: analizza l'input di un file in base a un formato.	Supportato.
fseek: cerca il puntatore di un file.	Supportata.	Supporta solo i file aperti utilizzando la modalità di lettura.
fstat: recupera le informazioni su un file utilizzando un puntatore a file aperto.	Supportato.
ftell: restituisce la posizione corrente del cursore di lettura/scrittura del file.	Supportato.
ftruncate: tronca un file fino a una determinata lunghezza.	Non supportati.	Restituisce sempre false.
fwrite: scrittura di file a sicurezza binaria.	Supportata.
glob: trova i nomi di percorso corrispondenti a un pattern.	Supportato.
is_dir: indica se il nome file è una directory.	Supportato.
is_executable: indica se il nome file è eseguibile.	Non supportati.	Restituisce sempre false.
is_file: indica se il nome del file è un file normale.	Supportato.
is_link: indica se il nome del file è un link simbolico.	Non supportati.	Restituisce sempre false.
is_readable: indica se un file esiste ed è leggibile.	Supportato.
is_uploaded_file: indica se il file è stato caricato tramite HTTP POST.	Supportata.
is_writable: indica se il nome file è scrivibile.	Supportato.	Il valore viene memorizzato nella cache e potrebbe non rispecchiare immediatamente le modifiche alle autorizzazioni.
is_writeable: alias di is_writable.
lchgrp: cambia la proprietà del link simbolico al gruppo.	Non supportati.	Questa opzione è disattivata.
lchown: modifica la proprietà del link simbolico da parte dell'utente.	Non supportati.	Questa opzione è Disattivata.
link: crea un collegamento fisico.	Non supportati.	Questa opzione è Disattivata.
linkinfo: recupera informazioni su un link.	Non supportati.	Restituisce sempre -1.
lstat: fornisce informazioni su un file o un link simbolico.	Supportato.
mkdir: crea una directory.	Supportata.
move_uploaded_file: sposta un file caricato in una nuova posizione.	Supportata.
parse_ini_file: analizza un file di configurazione.	Supportato.
pathinfo: restituisce informazioni su un percorso di file.	Supportata.
pclose: chiude il puntatore del file del processo.	Non supportati.	Questa opzione è Disattivata.
popen: apre il puntatore del file del processo.	Non supportati.	Questa opzione è Disattivata.
readfile: genera un file.	Supportato.
readlink: restituisce la destinazione di un link simbolico.	Non supportati.	Restituisce sempre false.
realpath: restituisce il nome di percorso assoluto canonicalizzato.	Non supportati.	Restituisce sempre false.
rename: rinomina un file o una directory.	Supportato.
rewind: torna indietro nella posizione di un cursore del file.	Supportata.	Supportata solo per la modalità di lettura.
rmdir: rimuove la directory.	Supportato.
set_file_buffer: alias di stream_set_write_buffer.
stat: fornisce informazioni su un file.	Supportata.
symlink: crea un link simbolico.	Non supportati.	Questa opzione è disattivata.
tempnam: crea un file con un nome univoco.	Supportata.	Consulta queste note.
tmpfile: crea un file temporaneo.	Supportato.	Restituisce un file basato sulla memoria simile a php://memory.
touch: imposta l'accesso e l'ora di modifica del file.	Non supportati.	Restituisce sempre false.
umask: modifica l'umask corrente.	Supportato.	Non si applica ai file di Cloud Storage.
unlink: elimina un file.	Supportata.

Tieni presente che le funzioni di statistiche dei file nella tabella precedente (file_exists, filemtime, filesize, fstat, is_file, is_dir, is_writable e stat) vengono memorizzate nella cache sulla base di ogni richiesta. Puoi svuotare questa cache chiamando clearstatcache.

Inoltre, sono supportate le seguenti funzioni di lettura della directory PHP:

Nome funzione
opendir
readdir
rewinddir
closedir

Nota: poiché le operazioni di elenco di Cloud Storage alla fine coerenti, readdir potrebbe non riflettere la modifica subito dopo l'aggiunta di un oggetto, rinominata o rimossa.

Utilizzo di include e require in PHP 5

Per contribuire a mantenere la sicurezza della tua applicazione, la possibilità di include o require da un file Cloud Storage è disabilitato per impostazione predefinita, ma puoi abilitarlo in questo modo:

Per include o require codice PHP da Google Cloud Storage nella tua applicazione, devi specificare i bucket contengono questi file utilizzando la direttiva google_app_engine.allow_include_gs_buckets nel file php.ini.

Lettura e scrittura di metadati personalizzati

Per allegare metadati personalizzati a un file in fase di scrittura in Google Cloud Storage, aggiungi i metadati in $options prima di creare il contesto del flusso utilizzato per la chiamata file_put_contents.

In questo esempio, al metadato denominato foo viene assegnato il valore far e a un altro denominato bar viene assegnato il valore boo. L'esempio imposta anche tipo di contenuti su text/plain. Il contesto del flusso viene creato utilizzando le informazioni in $options come mostrato e il file viene scritto in Cloud Storage da utilizzando file_put_contents(), insieme ai metadati e al tipo di contenuti:

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

Per leggere il tipo di contenuti e i metadati personalizzati di un file, chiama fopen sul e poi usa CloudStorageTools::getContentType() per ottenere il tipo di contenuti e CloudStorageTools::getMetaData() per ottenere i metadati.

I metadati personalizzati e il tipo di contenuti sono disponibili quando il file puntatore restituito dalla chiamata fopen.

$fp = fopen("gs://${my_bucket}/hello_metadata.txt", 'r');
$content_type = CloudStorageTools::getContentType($fp);
$metadata = CloudStorageTools::getMetaData($fp);

Letture di file memorizzati nella cache

Per impostazione predefinita, il wrapper dello stream di App Engine per Cloud Storage memorizza nella cache le letture dei file in memcache per migliorare le prestazioni nelle letture successive. La memorizzazione nella cache può essere disattivata usando enable_cache nel contesto del flusso.

Nota: quando la memorizzazione nella cache è abilitata, i file letti da Cloud Storage vengono memorizzati nella cache man mano che vengono lette e la cache contiene anche le informazioni sul file relative in scrittura. Tieni presente che is_writable potrebbe eseguire query su informazioni su file non aggiornate. Inoltre, se modifichi l'ACL su un bucket Cloud Storage in concedere o negare le autorizzazioni di scrittura all'applicazione, questa modifica potrebbe richiedere per riflettere.

Per un ulteriore miglioramento delle prestazioni, puoi anche attivare la memorizzazione nella cache ottimistica, che legge l'oggetto file dalla cache senza verificare se l'oggetto sottostante è stato modificato in Google Cloud Storage dall'ultima volta che è stato memorizzato nella cache, utilizzando la direttiva enable_optimistic_cache (impostata su false per impostazione predefinita). La memorizzazione nella cache ottimistica è ideale per scenari di scrittura una volta e lettura molte volte.

Puoi anche modificare l'intervallo di tempo che un oggetto memorizzato nella cache rimanga valido usando l'istruzione read_cache_expiry_seconds, Trascorso questo periodo, l'oggetto verrà ri-memorizzato nella cache al successivo tentativo di lettura. Per impostazione predefinita è impostato su 1 ora (3600).

In questo esempio, la memorizzazione nella cache ottimistica è attivata e vengono configurati oggetti file da contrassegnare per una nuova memorizzazione nella cache da Google Cloud Storage dopo 5 minuti.

$options = [
    'gs' => [
        'enable_cache' => true,
        'enable_optimistic_cache' => true,
        'read_cache_expiry_seconds' => 300,
    ]
];
$context = stream_context_create($options);
file_put_contents("gs://${my_bucket}/hello_caching.txt", $newFileContent, 0, $context);