Il runtime PHP

La funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo con pacchetti aggiuntivi, supporto linguistico e la libreria PHP Functions Framework che supporta e richiama la funzione. Questo ambiente è identificato dalla versione della lingua ed è noto come ID runtime.

Preparazione della funzione

Puoi preparare una funzione direttamente dalla console Google Cloud o scriverla sulla tua macchina locale e caricarla. Per preparare la macchina locale per lo sviluppo in PHP, consulta Utilizzare PHP su Google Cloud.

Runtime PHP e immagini base supportati

Seleziona il runtime

Puoi selezionare uno dei runtime PHP supportati per la tua funzione durante il deployment.

Puoi selezionare una versione del runtime utilizzando la console Google Cloud o gcloud CLI. Fai clic sulla scheda per visualizzare le istruzioni sull'utilizzo dello strumento che preferisci:

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

Struttura del codice sorgente

Affinché le funzioni Cloud Run trovino la definizione della tua funzione, il codice sorgente deve seguire una struttura specifica. Per saperne di più, consulta Scrivi funzioni Cloud Run.

Configurazione PHP

Configura la funzione PHP con un php.ini file nella directory radice della funzione. Puoi visualizzare le impostazioni di configurazione PHP esistenti con la funzione phpinfo() come mostrato nel seguente esempio di codice:

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 '';
}

Specifica delle dipendenze

PHP utilizza Composer per gestire le dipendenze. Specifichi le dipendenze per la tua funzione aggiungendole a un file di progetto chiamato composer.json.

Il runtime PHP delle funzioni Cloud Run richiede che Functions Framework sia una dipendenza esplicita. Per aggiungere Functions Framework come dipendenza, esegui questo comando nella directory contenente il codice della funzione (questa directory deve contenere anche il file composer.json):

composer require google/cloud-functions-framework

In questo modo, Functions Framework viene aggiunto a composer.json e il pacchetto viene installato nella directory vendor/.

File autoload.php

Uno dei file contenuti nella directory vendor/ è autoload.php.

Aggiungi la seguente riga all'inizio degli script PHP per richiedere il file autoload.php, che require automaticamente le altre dipendenze della tua funzione:

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

Per impostazione predefinita, la directory vendor/ viene ignorata nel file .gcloudignore generato per ridurre il numero di file inviati nel deployment.