/openwhisk-runtime-php

Apache OpenWhisk Runtime PHP supports Apache OpenWhisk functions written in PHP

Primary LanguageScalaApache License 2.0Apache-2.0

Apache OpenWhisk runtimes for PHP

License Continuous Integration

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