Erweiterte PHP 5-Dateiverwaltung

Berechtigungen, Caching und Metadatenoptionen

Der App Engine-Stream-Wrapper für Cloud Storage bietet die folgenden Optionen zum Konfigurieren Ihres Streams:

Das folgende Snippet zeigt die Verwendung von Streamoptionen:

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

In diesem Snippet ist $options eine Reihe von Argumenten, die der Stream beim Schreiben neuer Objekte verwendet. Diese können mit stream_context_set_default als Standardoptionen festgelegt werden.

Unterstützung von PHP 5-Dateisystemfunktionen in Cloud Storage

Der App Engine-Stream-Wrapper für Cloud Storage unterstützt viele native PHP-Dateisystemfunktionen. Einige Funktionen werden nicht unterstützt, bei anderen wurde die Unterstützung geändert. In der folgenden Tabelle sind alle diese nativen Funktionen aufgeführt und es wird angegeben, ob die Funktion unterstützt wird oder nicht. Wenn eine Funktion mit Änderungen oder Einschränkungen unterstützt wird, werden diese angegeben.

Beachten Sie, dass die Funktionen der Dateistatistik in dieser Tabelle (file_exists, filemtime, filesize, fstat, is_file, is_dir, is_writable und stat) auf Anfragebasis im Cache gespeichert werden. Sie können diesen Cache durch Aufrufen von clearstatcache leeren.

Zusätzlich werden folgende PHP-Verzeichnislesefunktionen unterstützt:

Mit PHP 5 include und require

Die Verwendung von include und require in Bezug auf eine Cloud Storage-Datei ist standardmäßig deaktiviert, um die Sicherheit Ihrer Anwendung aufrechtzuerhalten. So können Sie sie jedoch aktivieren:

Wenn Sie PHP-Code aus Google Cloud Storage mit include oder require in Ihre Anwendung einfügen möchten, müssen Sie mit der google_app_engine.allow_include_gs_buckets-Anweisung in der php.ini-Datei angeben, in welchen Buckets diese Dateien enthalten sind.

Benutzerdefinierte Metadaten lesen und schreiben

Zum Anhängen benutzerdefinierter Metadaten an eine Datei, die in Google Cloud Storage geschrieben wird, fügen Sie die Metadaten zu $options hinzu, bevor Sie den Streamkontext für den Aufruf file_put_contents erstellen.

In diesem Beispiel erhalten Metadaten namens foo den far-Wert und eine andere namens bar den boo-Wert. In diesem Beispiel wird auch der Inhaltstyp auf text/plain gesetzt. Der Streamkontext wird mithilfe dieser Informationen in $options erstellt, und die Datei wird mithilfe von file_put_contents() sowie der Metadaten und dem Inhaltstyp in Cloud Storage geschrieben:

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

Zum Lesen der benutzerdefinierten Metadaten und des Inhaltstyps für eine Datei rufen Sie fopen für die Datei auf und verwenden dann CloudStorageTools::getContentType() und CloudStorageTools::getMetaData(), um den Inhaltstyp bzw. die Metadaten abzurufen.

Die benutzerdefinierten Metadaten und der Inhaltstyp sind verfügbar, wenn Sie den vom Aufruf fopen zurückgegebenen Dateizeiger erhalten haben.

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

Lesevorgänge im Cache gespeicherter Dateien

Standardmäßig werden Dateilesevorgänge vom App Engine-Stream-Wrapper für Cloud Storage in Memcache gespeichert, um die Leistung der folgenden Lesevorgänge zu erhöhen. Caching kann mithilfe der Anweisung enable_cache im Streamkontext deaktiviert werden.

Zur weiteren Leistungsverbesserung können Sie auch optimistisches Caching aktivieren. Dabei wird das Dateiobjekt aus dem Cache gelesen, ohne dass geprüft wird, ob das zugrunde liegende Objekt in Google Cloud Storage seit dem letzten Caching geändert wurde. Zum Aktivieren verwenden Sie die Anweisung enable_optimistic_cache (standardmäßig auf false gesetzt). Optimistisches Caching ist ideal für Szenarien mit einem Schreib- und vielen Lesezugriffen.

Sie können auch die Gültigkeitsdauer eines im Cache gespeicherten Objekts mit read_cache_expiry_seconds ändern. Nach dieser Dauer wird das Objekt beim nächsten Leseversuch wieder im Cache gespeichert. Standardmäßig ist dies auf 1 Stunde (3600) eingestellt.

In diesem Beispiel ist optimistisches Caching aktiviert und Dateiobjekte sind so konfiguriert, dass sie nach 5 Minuten für die erneute Speicherung im Cache aus Google Cloud Storage markiert werden.

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