Runtime PHP

Fungsi Cloud Run Anda berjalan di lingkungan yang terdiri dari versi sistem operasi dengan paket add-on, dukungan bahasa, dan library PHP Functions Framework yang mendukung dan memanggil fungsi Anda. Lingkungan ini diidentifikasi berdasarkan versi bahasa, dan dikenal sebagai ID runtime.

Persiapan fungsi

Anda dapat menyiapkan fungsi langsung dari konsol Google Cloud atau menulisnya di komputer lokal, lalu menguploadnya. Guna menyiapkan mesin lokal untuk pengembangan PHP, lihat Menggunakan PHP di Google Cloud.

Runtime PHP dan image dasar yang didukung

Runtime ID Runtime Tumpukan Image dasar runtime
PHP 8.4 php84 google-22-full (default) google-22-full/php84
PHP 8.3 php83 google-22-full (default) google-22-full/php83
PHP 8.2 php82 google-22-full (default) google-22-full/php82
PHP 8.1 php81 google-18-full google-18-full/php81
PHP 7.4 php74 google-18-full google-18-full/php74

Memilih runtime Anda

Anda dapat memilih salah satu runtime PHP yang didukung untuk fungsi Anda selama deployment.

Anda dapat memilih versi runtime menggunakan konsol Google Cloud , atau gcloud CLI. Klik tab untuk mendapatkan petunjuk cara menggunakan alat pilihan Anda:

gcloud

Tentukan image dasar PHP untuk fungsi Anda menggunakan tanda --base-image, saat men-deploy fungsi Anda. Contoh:

gcloud run deploy FUNCTION \
    --source . \
    --function FUNCTION_ENTRYPOINT \
    --base-image php84

Ganti:

  • FUNCTION dengan nama fungsi yang Anda deploy. Anda dapat menghilangkan parameter ini sepenuhnya, tetapi Anda akan diminta untuk memasukkan nama jika menghilangkannya.

  • FUNCTION_ENTRYPOINT dengan titik entri ke fungsi Anda dalam kode sumber. Ini adalah kode yang dieksekusi Cloud Run saat fungsi Anda berjalan. Nilai flag ini harus berupa nama fungsi atau nama class yang sepenuhnya memenuhi syarat yang ada dalam kode sumber Anda.

Untuk mendapatkan petunjuk mendetail tentang cara men-deploy fungsi menggunakan gcloud CLI, lihat Men-deploy fungsi di Cloud Run.

Konsol

Anda dapat memilih versi runtime saat membuat atau memperbarui fungsi Cloud Run di konsol Google Cloud . Untuk mengetahui petunjuk mendetail tentang cara men-deploy fungsi, lihat Men-deploy fungsi di Cloud Run.

Untuk memilih runtime di konsol Google Cloud saat Anda membuat fungsi, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Cloud Run:

    Buka Cloud Run

  2. Klik Write a function.

  3. Dalam daftar Runtime, pilih versi runtime PHP.

  4. Klik Buat, dan tunggu hingga Cloud Run membuat layanan menggunakan revisi placeholder.

  5. Konsol akan mengalihkan Anda ke tab Source tempat Anda dapat melihat kode sumber fungsi. Klik Simpan dan deploy ulang.

Untuk mengetahui petunjuk mendetail tentang cara memperbarui versi runtime setelah fungsi Anda di-deploy, lihat Men-deploy ulang kode sumber baru.

Struktur kode sumber

Agar fungsi Cloud Run dapat menemukan definisi fungsi Anda, kode sumber Anda harus mengikuti struktur tertentu. Baca artikel Menulis fungsi Cloud Run untuk mengetahui informasi selengkapnya.

Konfigurasi PHP

Anda mengonfigurasi fungsi PHP dengan file php.ini di direktori root fungsi Anda. Anda dapat melihat setelan konfigurasi PHP yang sudah ada dengan fungsi phpinfo() seperti yang ditunjukkan pada contoh kode berikut:


use Psr\Http\Message\ServerRequestInterface;

function phpInfoDemo(ServerRequestInterface $request): string
{
    // phpinfo() displays its output directly in the function's
    // HTTP response, so we don't need to explicitly return it
    //
    // Note: we recommend deleting the deployed Cloud Function once you no
    // longer need it, as phpinfo() may broadcast potential security issues.
    phpinfo();
    return '';
}

Menentukan dependensi

PHP menggunakan Composer untuk mengelola dependensi. Anda menentukan dependensi untuk fungsi dengan menambahkan dependensi ke file project bernama composer.json.

Runtime PHP fungsi Cloud Run memerlukan Functions Framework sebagai dependensi eksplisit. Untuk menambahkan Functions Framework sebagai dependensi, jalankan perintah berikut di direktori yang berisi kode fungsi Anda (direktori ini juga harus berisi file composer.json):

composer require google/cloud-functions-framework

Tindakan ini akan menambahkan Functions Framework ke composer.json dan menginstal paket di direktori vendor/.

File autoload.php

Salah satu file yang terdapat dalam direktori vendor/ Anda adalah autoload.php.

Tambahkan baris berikut ke bagian atas skrip PHP Anda untuk meminta file autoload.php, yang secara otomatis require dependensi lain dari fungsi Anda:

require_once __DIR__ . '/vendor/autoload.php';

Secara default, direktori vendor/ diabaikan dalam file .gcloudignore yang dihasilkan untuk mengurangi jumlah file yang dikirim dalam deployment.