Gestión avanzada de archivos de PHP 5

Opciones de permisos, almacenamiento en caché y metadatos

El envoltorio de flujo de App Engine para Cloud Storage ofrece las siguientes opciones para configurar el flujo:

En el siguiente fragmento se muestra cómo usar las opciones de la secuencia:

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

En el fragmento de código anterior, $options es un conjunto de argumentos que usará el flujo al escribir objetos nuevos. Se pueden definir como opciones predeterminadas con stream_context_set_default.

Compatibilidad con funciones del sistema de archivos de PHP 5 en Cloud Storage

El envoltorio de flujo de App Engine para Cloud Storage admite muchas funciones nativas del sistema de archivos de PHP. Algunas funciones no se admiten y otras se han modificado. En la siguiente tabla se enumeran todas estas funciones nativas y se indica si se admiten o no. Si una función es compatible, pero con modificaciones o limitaciones, se describen.

Ten en cuenta que las funciones de estadísticas de archivos de la tabla anterior (file_exists, filemtime, filesize, fstat, is_file, is_dir, is_writable y stat) se almacenan en caché por solicitud. Para borrar esta caché, llama a clearstatcache.

Además, se admiten las siguientes funciones de lectura de directorios de PHP:

Usar include y require en PHP 5

Para mantener la seguridad de tu aplicación, la capacidad de include o require desde un archivo de Cloud Storage está inhabilitada de forma predeterminada, pero puedes habilitarla de la siguiente manera:

Para include o require código PHP de Google Cloud Storage en tu aplicación, debes especificar qué contenedores contienen esos archivos mediante la directiva google_app_engine.allow_include_gs_buckets en tu archivo php.ini.

Leer y escribir metadatos personalizados

Para adjuntar metadatos personalizados a un archivo que se está escribiendo en Google Cloud Storage, añade los metadatos a $options antes de crear el contexto de la secuencia que se usa en la llamada file_put_contents.

En este ejemplo, a los metadatos llamados foo se les asigna el valor far y a los llamados bar se les asigna el valor boo. En el ejemplo también se asigna el valor text/plain al tipo de contenido. El contexto de la secuencia se crea con esta información en $options, tal como se muestra, y el archivo se escribe en Cloud Storage mediante file_put_contents(), junto con los metadatos y el tipo de contenido:

$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);

Para leer los metadatos personalizados y el tipo de contenido de un archivo, llama a fopen en el archivo y, a continuación, usa CloudStorageTools::getContentType() para obtener el tipo de contenido y CloudStorageTools::getMetaData() para obtener los metadatos.

Los metadatos personalizados y el tipo de contenido están disponibles una vez que se devuelve el puntero de archivo de la llamada fopen.

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

Lecturas de archivos en caché

De forma predeterminada, el envoltorio de flujo de App Engine para Cloud Storage almacena en caché las lecturas de archivos en memcached para mejorar el rendimiento en lecturas posteriores. El almacenamiento en caché se puede desactivar mediante la directiva enable_cache en el contexto de la emisión.

Para mejorar aún más el rendimiento, también puedes habilitar el almacenamiento en caché optimista, que leerá el objeto de archivo de la caché sin comprobar si el objeto subyacente se ha modificado en Google Cloud Storage desde la última vez que se almacenó en caché, mediante la directiva enable_optimistic_cache (que tiene el valor false de forma predeterminada). El almacenamiento en caché optimista es ideal para situaciones en las que se escribe una vez y se lee muchas veces.

También puedes cambiar el tiempo que un objeto almacenado en caché permanece válido mediante la directiva read_cache_expiry_seconds. Después de ese tiempo, el objeto se volverá a almacenar en caché en el siguiente intento de lectura. De forma predeterminada, se establece en 1 hora (3600).

En este ejemplo, el almacenamiento en caché optimista está activado y los objetos de archivo están configurados para que se marquen para volver a almacenarse en caché desde Google Cloud Storage después de 5 minutos.

$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);