Serverless infrastructure.
Put this code in a file called Greet.class.php:
use com\amazon\aws\lambda\Handler;
class Greet extends Handler {
/** @return com.amazon.aws.lambda.Lambda|callable */
public function target() {
return fn($event, $context) => sprintf(
'Hello %s from PHP %s via %s @ %s',
$event['name'],
PHP_VERSION,
$context->functionName,
$context->region
);
}
}The two parameters passed are $event (a value depending on where the lambda was invoked from) and $context (a Context instance, see below).
If you need to run any initialization code, you can do before returning the lambda from target(). This code is only run once during the initialization phase. It has access to the lambda's environment via $this->environment (an Environment instance, see below).
To test your lambda locally, run the following:
$ xp lambda test Greet '{"name":"Timm"}'
START RequestId: 9ff45cda-df9b-1b8c-c21b-5fe27c8f2d24 Version: $LATEST
END RequestId: 9ff45cda-df9b-1b8c-c21b-5fe27c8f2d24
REPORT RequestId: 9ff45cda-df9b-1b8c-c21b-5fe27c8f2d24 Init Duration: 922.19 ms...
"Hello Timm from PHP 8.0.10 via test @ us-east-1"This functionality is provided by the great LambCI Docker image!
The first step is to create and publish the runtime layer:
$ xp lambda runtime
$ aws lambda publish-layer-version \
--layer-name lambda-xp-runtime \
--zip-file fileb://./runtime-X.X.X.zip \
--region us-east-1...and create a role:
$ cat > /tmp/trust-policy.json
{
"Version": "2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": {"Service": "lambda.amazonaws.com"},
"Action": "sts:AssumeRole"
}]
}
$ aws iam create-role \
--role-name InvokeLambda \
--path "/service-role/" \
--assume-role-policy-document file:///tmp/trust-policy.jsonAfter ensuring your dependencies are up-to-date using composer, create the function:
$ xp lambda package Greet.class.php
$ aws lambda create-function \
--function-name greet \
--handler Greet \
--zip-file fileb://./function.zip \
--runtime provided \
--role "arn:aws:iam::XXXXXXXXXXXX:role/service-role/InvokeLambda" \
--region us-east-1 \
--layers "arn:aws:lambda:us-east-1:XXXXXXXXXXXX:layer:lambda-xp-runtime:1"To invoke the function:
$ aws lambda invoke \
--cli-binary-format raw-in-base64-out \
--function-name greet \
--payload '{"name":"Timm"}'
response.json
$ cat response.json
"Hello Timm from PHP 8.0.10 via greet @ us-east-1"After having initially created your lambda, you can update its code as follows:
$ xp lambda package Greet.class.php
$ aws lambda update-function-code \
--function-name greet \
--zip-file fileb://./function.zip \
--publishTo upgrade an existing runtime layer, build the new runtime and publish a new version by calling the following to create a new version:
$ xp lambda runtime
$ aws lambda publish-layer-version \
--layer-name lambda-xp-runtime \
--zip-file fileb://./runtime-X.X.X.zip \
--region us-east-1Now, switch the function over to use this new layer:
$ aws lambda update-function-configuration \
--function-name greet \
--layers "arn:aws:lambda:us-east-1:XXXXXXXXXXXX:layer:lambda-xp-runtime:2"The context object passed to the target lambda is defined as follows:
public class com.amazon.aws.lambda.Context implements lang.Value {
public string $awsRequestId
public string $invokedFunctionArn
public string $traceId
public string $clientContext
public string $cognitoIdentity
public string $deadline
public string $functionName
public string $functionVersion
public string $memoryLimitInMB
public string $logGroupName
public string $logStreamName
public string $region
public int $payloadLength
public function __construct(array $headers, array $environment)
public function remainingTime(?float $now): ?float
public function toString(): string
public function hashCode(): string
public function compareTo(var $value): int
}The runtime environment is defined as follows:
public class com.amazon.aws.lambda.Environment {
public string $root
public io.streams.StringWriter $writer
public util.PropertySource $properties
public function __construct(string $root, ?io.streams.StringWriter $writer)
public function taskroot(): io.Path
public function path(string $path): io.Path
public function tempDir(): io.Path
public function variable(string $name): ?string
public function trace(var... $args): void
public function properties(string $name): util.PropertyAccess
}Instead of functions, a handler's target() method may also return instances implementing the Lambda interface:
public interface com.amazon.aws.lambda.Lambda {
public function process(var $event, com.amazon.aws.lambda.Context $context): var
}