Environnement d'exécution PHP

Votre fonction Cloud Run s'exécute dans un environnement composé d'une version de système d'exploitation avec des packages complémentaires, d'une compatibilité avec les langages et de la bibliothèque du framework des fonctions PHP compatible avec votre fonction et qui l'appelle. Cet environnement est identifié par la version de langage et est appelé ID d'exécution.

Préparation de la fonction

Vous pouvez préparer une fonction directement depuis la console Google Cloud , ou l'écrire sur votre ordinateur local et l'importer. Pour préparer votre ordinateur local pour le développement PHP, consultez Utiliser PHP sur Google Cloud.

Sélectionner votre environnement d'exécution

Cloud Run Functions est compatible avec plusieurs versions de PHP, répertoriées dans la section Environnements d'exécution de langage et images de base compatibles. Vous pouvez sélectionner l'environnement d'exécution PHP pour votre fonction lors du déploiement.

gcloud

Pour utiliser des fonctions Cloud Run pour déployer une fonction HTTP à l'aide de gcloud CLI, consultez la section Déployer à l'aide de Google Cloud CLI.

Console

Si vous utilisez la console Google Cloud , sélectionnez l'environnement d'exécution lorsque vous créez et déployez votre fonction. Pour obtenir des instructions détaillées, consultez le guide de démarrage rapide de la consoleGoogle Cloud .

Structure du code source

Pour que Cloud Run Functions trouve la définition de votre fonction, votre code source doit respecter une structure spécifique. Pour en savoir plus, consultez la page Écrire des fonctions Cloud Run.

Configuration PHP

Vous configurez votre fonction PHP avec un fichier php.ini dans le répertoire racine de votre fonction. Vous pouvez afficher les paramètres de configuration PHP existants avec la fonction phpinfo(), comme indiqué dans l'exemple de code suivant :


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

Spécifier des dépendances

PHP utilise Composer pour gérer les dépendances. Vous spécifiez des dépendances pour votre fonction en les ajoutant à un fichier de projet appelé composer.json.

L'environnement d'exécution PHP des fonctions Cloud Run nécessite que le framework des fonctions soit une dépendance explicite. Pour ajouter le framework des fonctions en tant que dépendance, exécutez la commande suivante dans le répertoire contenant le code de votre fonction (ce répertoire doit également contenir le fichier composer.json):

composer require google/cloud-functions-framework

Cette commande ajoute le framework des fonctions à votre fichier composer.json et installe le package dans le répertoire vendor/.

Fichier autoload.php

L'un des fichiers contenus dans votre répertoire vendor/ est autoload.php.

Ajoutez la ligne suivante au début de vos scripts PHP pour exiger le fichier autoload.php, ce qui va exiger (require) automatiquement les autres dépendances de votre fonction :

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

Par défaut, le répertoire vendor/ est ignoré dans le fichier .gcloudignore généré afin de réduire le nombre de fichiers envoyés en déploiement.