Environnement d'exécution PHP

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

Ces environnements d'exécution utilisent nginx et PHP-FPM pour diffuser les requêtes. Pour en savoir plus sur les environnements d'exécution en général et découvrir la version d'Ubuntu utilisée par chaque environnement d'exécution PHP, consultez la page Environnement d'exécution des fonctions Cloud Run.

Pour commencer à utiliser PHP sur Cloud Run Functions, consultez le guide de démarrage rapide.

Sélectionner votre environnement d'exécution

Cloud Run Functions est compatible avec plusieurs versions de PHP, répertoriées sur la page Compatibilité des environnements d'exécution. Vous pouvez sélectionner l'environnement d'exécution PHP pour votre fonction lors du déploiement.

gcloud

Si vous utilisez Google Cloud CLI, spécifiez l'environnement d'exécution à l'aide du paramètre --runtime. NAME spécifie le nom de la fonction. Exemple :

gcloud functions deploy NAME --runtime php82 --trigger-http FLAGS...

FLAGS... fait référence aux arguments transmis lors du premier déploiement de votre fonction. Pour en savoir plus sur les arguments obligatoires et facultatifs, consultez la page Déployer à l'aide de Google Cloud CLI.

Console

Si vous utilisez la console Google Cloud, consultez le guide de démarrage rapide de la console Google Cloud pour obtenir des instructions détaillées.

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.

La bibliothèque qui appelle votre fonction est le framework des fonctions PHP.

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

Vous spécifiez des dépendances pour votre fonction en les ajoutant à un fichier de projet appelé composer.json. Pour en savoir plus, consultez la page Spécifier des dépendances en PHP.

Étapes suivantes