高度な PHP 5 ファイル管理

権限、キャッシュ、メタデータのオプション

Cloud Storage 用 App Engine ストリーム ラッパーには、ストリームを構成するための次のオプションがあります。

次のスニペットは、ストリーム オプションの使用方法を示しています。

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

上のスニペットの $options は、新しいオブジェクトを書き込むときにストリームが使用する引数のセットです。stream_context_set_default を使用すると、これがデフォルトのオプションとして設定されます。

Cloud Storage で使用可能な PHP 5 ファイル システム関数

Cloud Storage 用 App Engine ストリーム ラッパーでは、多くのネイティブ PHP ファイル システム関数がサポートされていますが、サポートされていないものや、変更されたものもあります。次の表に、このようなネイティブ関数とサポート状況を示します。サポート対象の関数でも、変更や制限がある場合は以下に記載されています。

上記の表のファイル統計関数（file_exists、filemtime、filesize、fstat、is_file、is_dir、is_writable、stat）はリクエストごとにキャッシュされます。このキャッシュをクリアするには、clearstatcache を呼び出します。

また、次の PHP ディレクトリ読み取り関数がサポートされています。

PHP 5 include と require の使用

アプリケーションのセキュリティを維持するため、Cloud Storage ファイルからの include と require の機能はデフォルトで無効になっていますが、次のようにして有効にできます。

アプリケーションで Google Cloud Storage の PHP コードの include または require を行うには、php.ini ファイルで google_app_engine.allow_include_gs_buckets ディレクティブを使用し、これらのファイルが含まれているバケットを指定する必要があります。

カスタム メタデータの読み取りと書き込み

Google Cloud Storage に書き込むファイルにカスタム メタデータを追加するには、file_put_contents 呼び出しに使用するストリーム コンテキストを作成する前に、メタデータを $options に追加します。

この例では、foo という名前のメタデータに値 far が割り当てられ、bar という名前のメタデータに値 boo が割り当てられています。この例では、コンテンツ タイプも text/plain に設定しています。ストリーム コンテキストは、示されたとおり $options の情報を使用して作成され、ファイルは file_put_contents() を使用してメタデータとコンテンツ タイプとともに Cloud Storage に書き込まれます。

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

ファイルのカスタム メタデータとコンテンツ タイプを読み取るには、ファイルに対して fopen を呼び出します。次に、コンテンツ タイプを取得するには CloudStorageTools::getContentType()、メタデータを取得するには CloudStorageTools::getMetaData() を使用します。

fopen 呼び出しからファイル ポインタが返されたら、カスタム メタデータとコンテンツ タイプが利用可能になります。

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

キャッシュに保存されたファイルの読み取り

デフォルトでは、Cloud Storage 用 App Engine ストリーム ラッパーはファイルの読み取りを memcache に保存し、後続の読み取りパフォーマンスを向上させます。ストリーム コンテキストで enable_cache ディレクティブを使用すると、キャッシュへの保存はオフになります。

パフォーマンスのさらなる向上のために、楽観的キャッシュを有効にすることもできます。これにより、元となるオブジェクトが最後にキャッシュされてから Google Cloud Storage で変更されたかは確認せずに、enable_optimistic_cache ディレクティブ（デフォルトでは false に設定）を使用して、キャッシュからファイル オブジェクトを読み取ります。楽観的キャッシュは、書き込みが 1 回限りで何回も読み取りを行う場合に最適です。

また、read_cache_expiry_seconds ディレクティブを使用して、キャッシュされたオブジェクトの有効期間を変更できます。この期間が経過すると、オブジェクトが次の読み取り時に再度キャッシュに保存されます。デフォルトでは 1 時間（3600）に設定されています。

この例では、楽観的キャッシュが有効になっています。ファイル オブジェクトは、5 分後に Google Cloud Storage から再度キャッシュに保存されるように構成されています。

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