Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/googlecloudplatform/functions-framework-php

FaaS (Function as a service) framework for writing portable PHP functions
https://github.com/googlecloudplatform/functions-framework-php

cloud-functions functions-as-a-service google-cloud php

Last synced: 4 days ago
JSON representation

FaaS (Function as a service) framework for writing portable PHP functions

Awesome Lists containing this project

README 

        
# Functions Framework for PHP [![Packagist](https://poser.pugx.org/google/cloud-functions-framework/v/stable)](https://packagist.org/packages/google/cloud-functions-framework)



[![PHP unit CI][ff_php_unit_img]][ff_php_unit_link] [![PHP lint CI][ff_php_lint_img]][ff_php_lint_link] [![PHP conformace CI][ff_php_conformance_img]][ff_php_conformance_link] ![Security Scorecard](https://api.securityscorecards.dev/projects/github.com/GoogleCloudPlatform/functions-framework-php/badge)



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](https://github.com/knative/)-based environments



The framework allows you to go from:



```php

use Psr\Http\Message\ServerRequestInterface;



function helloHttp(ServerRequestInterface $request)

{

    return "Hello World from a PHP HTTP function!" . PHP_EOL;

}

```



To:



```sh

curl http://my-url

# Output: "Hello World from a PHP HTTP function!"

```



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

handling logic.



> Watch [this video](https://youtu.be/yMEcyAkTliU?t=912) 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](https://cloudevents.io/) spec

*   Portable between serverless platforms



# Installation



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

[Composer][composer].



```sh

composer require google/cloud-functions-framework

```



[composer]: https://getcomposer.org/



# Define your Function



Create an `index.php` file with the following contents:



```php

getQueryParams()['name'] ?? 'World');

}

```



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.



```php

use Psr\Http\Message\ServerRequestInterface;

use Psr\Http\Message\ResponseInterface;

use GuzzleHttp\Psr7\Response;

use GuzzleHttp\Psr7\Utils;



function helloHttp(ServerRequestInterface $request): ResponseInterface

{

    $body = sprintf("Hello %s from PHP HTTP function!" . PHP_EOL,

        $request->getQueryParams()['name'] ?? 'World');



    return (new Response())

        ->withBody(Utils::streamFor($body))

        ->withStatus(418) // I'm a teapot

        ->withHeader('Foo', 'Bar');

}

```



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



```

HTTP/1.1 418 I'm a teapot

Host: localhost:8080

Date: Wed, 03 Jun 2020 00:48:38 GMT

Foo: Bar



Hello World from PHP HTTP function!

```



See the [PSR-7 documentation][psr7] documentation for more on working

with the request and response objects.



[psr7]: https://www.php-fig.org/psr/psr-7/



## 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:



```php

// Get the contents of an object in GCS

$object = file_get_contents('gs://{YOUR_BUCKET_NAME}/object.txt');

// Make modifications

$object .= "\nadd a line";

// Write the new contents back to GCS

file_put_contents('gs://{YOUR_BUCKET_NAME}/object.txt', $object);

```



You can unregister this at any time by using

[`stream_wrapper_unregister`][stream_wrapper_unregister]:



```php

// unregister the automatically registered one

stream_wrapper_unregister('gs');

```



[stream_wrapper_unregister]: https://www.php.net/manual/en/function.stream-wrapper-unregister.php



## Run your function on Knative



Cloud Run and Cloud Run on GKE both implement the

[Knative Serving API](https://www.knative.dev/docs/). 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](https://cloud.google.com/run/docs/quickstarts/prebuilt-deploy-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:



| Environment variable      | Description

| ------------------------- | -----------

| `FUNCTION_TARGET`         | The name of the exported function to be invoked in response to requests.

| `FUNCTION_SOURCE` | The name of the file containing the source code for your function to load. Default: **`index.php`** (if it exists)

| `FUNCTION_SIGNATURE_TYPE` | The signature used when writing your function. Controls unmarshalling rules and determines which arguments are used to invoke your function. Can be either `http`, `event`, or `cloudevent`. Default: **`http`**



# Contributing



Contributions to this library are welcome and encouraged. See

[CONTRIBUTING](CONTRIBUTING.md) for more information on how to get started.



[ff_php_unit_img]: https://github.com/GoogleCloudPlatform/functions-framework-php/workflows/PHP%20Unit%20CI/badge.svg

[ff_php_unit_link]:  https://github.com/GoogleCloudPlatform/functions-framework-php/actions?query=workflow%3A"PHP+Unit+CI"

[ff_php_lint_img]: https://github.com/GoogleCloudPlatform/functions-framework-php/workflows/PHP%20Lint%20CI/badge.svg

[ff_php_lint_link]:  https://github.com/GoogleCloudPlatform/functions-framework-php/actions?query=workflow%3A"PHP+Lint+CI"

[ff_php_conformance_img]: https://github.com/GoogleCloudPlatform/functions-framework-php/workflows/PHP%20Conformance%20CI/badge.svg

[ff_php_conformance_link]:  https://github.com/GoogleCloudPlatform/functions-framework-php/actions?query=workflow%3A"PHP+Conformance+CI"