Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/apache/openwhisk-runtime-php

Apache OpenWhisk Runtime PHP supports Apache OpenWhisk functions written in PHP
https://github.com/apache/openwhisk-runtime-php

apache cloud docker faas functions functions-as-a-service openwhisk openwhisk-runtime php serverless serverless-architectures serverless-functions

Last synced: about 1 month ago
JSON representation

Apache OpenWhisk Runtime PHP supports Apache OpenWhisk functions written in PHP

Awesome Lists containing this project

README 

        



# Apache OpenWhisk runtimes for PHP

[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)

[![Continuous Integration](https://github.com/apache/openwhisk-runtime-php/actions/workflows/ci.yaml/badge.svg)](https://github.com/apache/openwhisk-runtime-php/actions/workflows/ci.yaml)



## PHP versions



This runtime provides PHP 8.3, 8.2 and 8.1



### Give it a try today

To use as a docker action



PHP 8.3:

```

wsk action update myAction myAction.php --docker openwhisk/action-php-v8.3:latest

```



PHP 8.2:

```

wsk action update myAction myAction.php --docker openwhisk/action-php-v8.2:latest

```



PHP 8.1:

```

wsk action update myAction myAction.php --docker openwhisk/action-php-v8.1:latest

```



This works on any deployment of Apache OpenWhisk



### To use on deployment that contains the runtime as a kind

To use as a kind action



PHP 8.3:

```

wsk action update myAction myAction.php --kind php:8.3

```



PHP 8.2:

```

wsk action update myAction myAction.php --kind php:8.2

```



PHP 8.1:

```

wsk action update myAction myAction.php --kind php:8.1

```



### Local development



```

./gradlew core:php8.3Action:distDocker

./gradlew core:php8.2Action:distDocker

./gradlew core:php8.1Action:distDocker

```

This will produce the images `whisk/action-php-v8.3`, `whisk/action-php-v8.2` and `whisk/action-php-v8.1` respectively.



Build and Push image

```

docker login

./gradlew core:php8.3Action:distDocker -PdockerImagePrefix=$prefix-user -PdockerRegistry=docker.io

./gradlew core:php8.2Action:distDocker -PdockerImagePrefix=$prefix-user -PdockerRegistry=docker.io

./gradlew core:php8.1Action:distDocker -PdockerImagePrefix=$prefix-user -PdockerRegistry=docker.io

```



Deploy OpenWhisk using ansible environment that contains the kinds `php:8.3`, `php:8.2` and `php:8.1`

Assuming you have OpenWhisk already deploy locally and `OPENWHISK_HOME` pointing to root directory of OpenWhisk core repository.



Set `ROOTDIR` to the root directory of this repository.



Redeploy OpenWhisk

```

cd $OPENWHISK_HOME/ansible

ANSIBLE_CMD="ansible-playbook -i ${ROOTDIR}/ansible/environments/local"

$ANSIBLE_CMD setup.yml

$ANSIBLE_CMD couchdb.yml

$ANSIBLE_CMD initdb.yml

$ANSIBLE_CMD wipe.yml

$ANSIBLE_CMD openwhisk.yml

```



Or you can use `wskdev` and create a soft link to the target ansible environment, for example:

```

ln -s ${ROOTDIR}/ansible/environments/local ${OPENWHISK_HOME}/ansible/environments/local-php

wskdev fresh -t local-php

```



To use as docker action push to your own dockerhub account

```

docker tag whisk/php8.2Action $user_prefix/action-php-v8.3

docker push $user_prefix/action-php-v8.3

```

```

docker tag whisk/php8.2Action $user_prefix/action-php-v8.2

docker push $user_prefix/action-php-v8.2

```

```

docker tag whisk/php8.1Action $user_prefix/action-php-v8.1

docker push $user_prefix/action-php-v8.1

```



Then create the action using your image from dockerhub

```

wsk action update myAction myAction.php --docker $user_prefix/action-php-v8.1

```

The `$user_prefix` is usually your dockerhub user id.



### Testing

Install dependencies from the root directory on $OPENWHISK_HOME repository

```

./gradlew install

```



Using gradle for the ActionContainer tests you need to use a proxy if running on Mac, if Linux then don't use proxy options

You can pass the flags `-Dhttp.proxyHost=localhost -Dhttp.proxyPort=3128` directly in gradle command.

Or save in your `$HOME/.gradle/gradle.properties`

```

systemProp.http.proxyHost=localhost

systemProp.http.proxyPort=3128

```

Using gradle to run all tests

```

./gradlew :tests:test

```

Using gradle to run some tests

```

./gradlew :tests:test --tests *ActionContainerTests*

```

Using IntelliJ:

- Import project as gradle project.

- Make sure the working directory is root of the project/repo

- Add the following Java VM properties in ScalaTests Run Configuration, easiest is to change the Defaults for all ScalaTests to use this VM properties

```

-Dhttp.proxyHost=localhost

-Dhttp.proxyPort=3128

```