Your Cloud Run function runs in an environment consisting of anoperating system version with add-on packages, language support, andthePHP Functions Frameworklibrary that supports and invokes your function. This environment is identifiedby the language version, and is known as the runtime ID.

Function preparation

You can prepare a function directly from the Google Cloud console or write it onyour local machine and upload it. To prepare your local machine for PHPdevelopment, seeUse PHP on Google Cloud.

Supported PHP runtimes and base images

Select your runtime

You can select one of the supported PHP runtimes for your function duringdeployment.

You can select a runtime version using the Google Cloud console, or thegcloud CLI. Click the tab for instructions on using the tool ofyour choice:

gcloud run deployFUNCTION \    --source . \    --functionFUNCTION_ENTRYPOINT \    --base-image php84

Source code structure

For Cloud Run functions to find your function's definition, yoursource code must follow a specific structure. SeeWrite Cloud Run functions formore information.

PHP Configuration

You configure your PHP function with aphp.inifile in your function'sroot directory. You can view existing PHP configuration settings with thephpinfo() function asshown in the following code sample:

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

Specifying dependencies

PHP uses Composer to manage dependencies. You specify dependencies for yourfunction by adding the dependencies to a project file calledcomposer.json.

The Cloud Run functions PHP runtime requires the FunctionsFramework to be an explicit dependency. To add Functions Framework as adependency, run the following command in the directory containing your functioncode (this directory must also contain thecomposer.json file):

composer require google/cloud-functions-framework

This adds the Functions Framework to yourcomposer.json and installs thepackage in thevendor/ directory.

autoload.php file

One of the files contained in yourvendor/ directory isautoload.php.

Add the following line to the top of your PHP scripts to require theautoload.php file, which automaticallyrequires your function's otherdependencies:

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

By default, thevendor/ directory is ignored in the generated.gcloudignore file to reduce thenumber of files sent in deployment.