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 include 或 require 取得 PHP 程式碼，您必須在 php.ini 檔案中使用 google_app_engine.allow_include_gs_buckets 指令，指定哪些值區包含這些檔案。

讀取及寫入自訂中繼資料

如要將自訂中繼資料附加至要寫入 Google Cloud Storage 的檔案，請先將中繼資料新增至 $options，然後再建立用於 file_put_contents 呼叫的串流結構定義。

在這個範例中，名為 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 指令。

如要進一步改善效能，您也可以啟用樂觀快取功能，這樣系統就會使用 enable_optimistic_cache 指令 (預設為 false) 從快取中讀取檔案物件，而不會查看基礎物件是否在 Google Cloud Storage 中自上次快取後有所變更。樂觀快取非常適合一次寫入、多次讀取的情境。

您也可以使用 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);