Download the PHP package google/cloud-functions-framework without Composer

Functions Framework for PHP

An open source FaaS (Function as a service) framework for writing portable PHP functions.

The Functions Framework lets you write lightweight functions that run in many different environments, including:

• Your local development machine
• Knative-based environments

The framework allows you to go from:

To:

All without needing to worry about writing an HTTP server or complicated request handling logic.

Watch this video to learn more about Functions Frameworks.

Features

• Spin up a local development server for quick testing
• Invoke a function in response to a request
• Automatically unmarshal events conforming to the CloudEvents spec
• Portable between serverless platforms

Installation

Add the Functions Framework to your composer.json file using Composer.

Define your Function

Create an index.php file with the following contents:

Quickstarts

Run your function locally

After completing the steps under Installation and Define your Function, run the following commands:

Open http://localhost:8080/ in your browser and see Hello World from a PHP HTTP function!.

Run your function in a container

After completing the steps under Installation and Define your Function, build the container using the example Dockerfile:

Run the cloud functions framework container:

Open http://localhost:8080/ in your browser and see Hello World from a PHP HTTP function. You can also send requests to this function using curl from another terminal window:

Run your function on Google Cloud Run Functions

NOTE: For an extensive list of samples, see the [PHP functions samples][functions-samples] and the [official how-to guides][functions-how-to].

Follow the Cloud Run function quickstart for PHP to learn how to deploy a function to Cloud Run.

Run your function as a container in Cloud Run

You can manually build your function as a container and deploy it into Cloud Run. Follow the Cloud Run instructions for building a function for complete instructions.

Use CloudEvents

The Functions Framework can unmarshall incoming CloudEvents payloads to a cloudevent object. This will be passed as arguments to your function when it receives a request. Note that your function must use the cloudevent function signature:

You will also need to set the FUNCTION_SIGNATURE_TYPE environment variable to cloudevent.

In a separate tab, make a cURL request in Cloud Event format to your function:

Your original process should output the following:

IMPORTANT: The above tutorials to deploy to a docker container and to Cloud Run work for CloudEvents as well, as long as FUNCTION_TARGET and FUNCTION_SIGNATURE_TYPE are set appropriately.

Working with PSR-7 HTTP Objects

The first parameter of your function is a Request object which implements the PSR-7 ServerRequestInterface:

You can return a PSR-7 compatible ResponseInterface instead of a string. This allows you to set additional request properties such as the HTTP Status Code and headers.

A request to this function will produce a response similar to the following:

See the PSR-7 documentation documentation for more on working with the request and response objects.

Use Google Cloud Storage

When you require the google/cloud-storage package with composer, the functions framework will register the gs:// stream wrapper. This enables your function to read and write to Google Cloud Storage as you would any filesystem:

You can unregister this at any time by using stream_wrapper_unregister:

Run your function on Knative

Cloud Run and Cloud Run on GKE both implement the Knative Serving API. The Functions Framework is designed to be compatible with Knative environments. Just build and deploy your container to a Knative environment.

If you want even more control over the environment, you can deploy your container image to Cloud Run on GKE. With Cloud Run on GKE, you can run your function on a GKE cluster, which gives you additional control over the environment (including use of GPU-based instances, longer timeouts and more).

Configure the Functions Framework

You can configure the Functions Framework using the environment variables shown below:

Contributing

Contributions to this library are welcome and encouraged. See CONTRIBUTING for more information on how to get started.