Pengelolaan File PHP 5 Lanjutan

Opsi izin, cache, dan metadata

Wrapper streaming App Engine untuk Cloud Storage menyediakan opsi berikut untuk mengonfigurasi aliran data Anda:

Cuplikan berikut menunjukkan cara menggunakan opsi streaming:

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

Dalam cuplikan kode di atas, $options adalah sekumpulan argumen yang akan digunakan aliran data saat menulis objek baru, yang dapat ditetapkan sebagai opsi default menggunakan stream_context_set_default.

Dukungan fungsi sistem file PHP 5 di Cloud Storage

Wrapper streaming App Engine untuk Cloud Storage mendukung banyak fungsi filesystem PHP native. Beberapa fungsi tidak didukung, dan beberapa memiliki dukungan yang dimodifikasi. Tabel berikut mencantumkan setiap fungsi native tersebut, yang menunjukkan apakah fungsi tersebut didukung atau tidak. Jika suatu fungsi didukung tetapi dengan modifikasi atau batasan, fungsi tersebut akan dijelaskan.

Perhatikan bahwa statistik file yang berfungsi dalam tabel di atas (file_exists, filemtime, filesize, fstat, is_file, is_dir, is_writable, dan stat) di-cache berdasarkan permintaan. Anda dapat menghapus cache ini dengan memanggil clearstatcache.

Selain itu, fungsi membaca direktori PHP berikut ini didukung:

Menggunakan include dan require PHP 5

Untuk membantu menjaga keamanan aplikasi, kemampuan untuk include atau require dari file Cloud Storage dinonaktifkan secara default, tetapi Anda dapat mengaktifkannya seperti berikut:

Untuk include atau kode PHP require dari Google Cloud Storage di aplikasi, Anda harus menentukan bucket mana yang berisi bucket tersebut menggunakan perintah google_app_engine.allow_include_gs_buckets di file php.ini Anda.

Membaca dan menulis metadata kustom

Untuk melampirkan metadata kustom ke file yang sedang ditulis ke Google Cloud Storage, tambahkan metadata tersebut ke $options sebelum membuat konteks streaming yang digunakan untuk panggilan file_put_contents.

Dalam contoh ini, metadata bernama foo diberi nilai far, dan metadata lain bernama bar diberi nilai boo. Contoh ini juga menetapkan jenis konten ke text/plain. Konteks streaming dibuat menggunakan informasi ini di $options seperti yang ditunjukkan, dan file ditulis ke Cloud Storage menggunakan file_put_contents(), bersama dengan metadata dan jenis konten:

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

Untuk membaca metadata kustom dan jenis konten untuk file, panggil fopen pada file, lalu gunakan CloudStorageTools::getContentType() untuk mendapatkan jenis konten dan CloudStorageTools::getMetaData() untuk mendapatkan metadata.

Metadata kustom dan jenis konten tersedia setelah Anda memiliki pointer file yang ditampilkan dari panggilan fopen.

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

Pembacaan file yang di-cache

Secara default, wrapper streaming App Engine untuk file cache Cloud Storage dibaca menjadi memcache guna meningkatkan performa pada pembacaan berikutnya. Penyimpanan ke cache dapat dinonaktifkan menggunakan perintah enable_cache dalam konteks aliran data.

Untuk peningkatan performa lebih lanjut, Anda juga dapat mengaktifkan penyimpanan dalam cache optimis, yang akan membaca objek file dari cache tanpa melihat apakah objek yang mendasarinya telah diubah di Google Cloud Storage sejak terakhir kali disimpan dalam cache, menggunakan perintah enable_optimistic_cache (ditetapkan kefalse secara default). Cache optimis sangat ideal untuk skenario tulis-sekali, baca-banyak.

Anda juga dapat mengubah durasi waktu objek yang di-cache tetap valid dengan menggunakan perintah read_cache_expiry_seconds, setelah itu objek akan disimpan dalam cache ulang pada upaya baca berikutnya. Secara default, waktunya ditetapkan ke 1 jam (3600).

Dalam contoh ini, caching optimis diaktifkan, dan objek file dikonfigurasi agar ditandai untuk disimpan ke dalam cache ulang dari Google Cloud Storage setelah 5 menit.

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