Stay organized with collections Save and categorize content based on your preferences.

The PHP Runtime

Cloud Functions supports the following PHP runtimes:

  • PHP 8.1 (recommended)
  • PHP 7.4

For instructions on how to prepare your local machine for PHP development, see Using PHP on Google Cloud.

To get started with PHP on Cloud Functions, see the Quickstart.

Execution environment

The execution environment includes the PHP runtime, the operating system, an application server, and a library that invokes your function.

The PHP runtime uses an execution environment based on Ubuntu 18.04 using nginx and PHP-FPM. See Cloud Functions execution environment for more information.

The library that invokes your function is the PHP Functions Framework.

PHP Configuration

PHP functions can be configured by placing a php.ini file in your function's root directory.

For a comprehensive look at the PHP configuration, you can deploy a function running phpinfo(), for example:

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.
    return '';

Read up on the PHP 7 runtime for information on available extensions and default php.ini directives.

Selecting the runtime

You can select the PHP runtime for your function during deployment.


If you are using the Google Cloud CLI, you can specify the runtime by using the --runtime parameter. NAME specifies the function name. For example:

gcloud functions deploy NAME --runtime php81 --trigger-http

For more arguments that you can specify when you are deploying, see Deploy using the gcloud tool.


If you are using the Google Cloud console, you can select the runtime when you create and deploy a function. See the Google Cloud console quickstart for detailed instructions.

Source code structure

In order for Cloud Functions to find your function's definition, each runtime has certain structuring requirements for your source code. See Writing Cloud Functions for more information.

Specifying dependencies

You can specify dependencies for your function by adding them to a project file called composer.json. For more information, see Specifying dependencies in PHP.

What's next