Gambar Penyajian

App Engine API untuk Cloud Storage Tools menyediakan metode yang mudah untuk menyajikan file gambar:

• CloudStorageTools.getImageServingUrl()
• CloudStorageTools.deleteImageServingUrl()

Halaman ini menjelaskan cara menggunakan API dan layanan paket lama. API ini hanya dapat berjalan di runtime generasi pertama di lingkungan standar App Engine. Jika Anda mengupdate ke runtime App Engine PHP 7/8, lihat dokumentasi panduan migrasi guna mempelajari opsi migrasi Anda untuk paket layanan lama.

Catatan: Saat menjalankan aplikasi secara lokal di server pengembangan, Anda harus menginstal PIL jika ingin menggunakan opsi ukuran gambar yang dijelaskan di halaman ini.

Salah satu keuntungan menggunakan metode ini untuk menyajikan gambar daripada membuat file menjadi publik adalah kemampuan untuk mengubah ukuran dan memangkas secara dinamis, tanpa perlu menyimpan gambar dalam ukuran yang berbeda.

CloudStorageTools::getImageServingUrl menampilkan URL penyajian untuk gambar. Jika gambar akan ditampilkan dalam halaman HTTPS, tetapkan secure_url ke True untuk menghindari peringatan konten campuran.

Perhatikan bahwa URL ini dapat dibaca secara publik oleh semua orang, tetapi tidak "dapat ditebak".

Penting: Anda tidak dapat menyajikan gambar dari dua aplikasi terpisah; hanya aplikasi pertama yang memanggil getImageServingUrl yang dapat memperoleh URL untuk menyajikannya, karena aplikasi tersebut telah memperoleh kepemilikan gambar untuk menyajikannya. Oleh karena itu, aplikasi lain yang memanggil getImageServingUrl pada gambar tidak akan berhasil. Jika aplikasi kedua harus menyajikan gambar, aplikasi harus menyalin gambar terlebih dahulu, lalu memanggil getImageServingUrl pada salinan.

Untuk berhenti menyajikan URL, panggil CloudStorageTools::deleteImageServingUrl.

Catatan: Jika Anda ingin menghapus file tersebut, gunakan fungsi unlink() PHP.

Untuk menggunakan fitur ini, impor class CloudStorageTools:

use google\appengine\api\cloud_storage\CloudStorageTools;

Sekarang ubah ukuran dan pangkas gambar image.jpg:

$options = ['size' => 400, 'crop' => true];
$image_file = "gs://${my_bucket}/image.jpg";
$image_url = CloudStorageTools::getImageServingUrl($image_file, $options);