Request handler

A request handler is a method used to handle each function invocation. When creating a function version, you should specify the entry point that consists of the file name and request handler name (for example, index.myFunction).

When invoking the handler, the runtime passes the following arguments:

1. The request body (the event parameter).

   If the request body is a JSON document, it's converted to an Array using the json_decode method.

2. The invocation context (the context parameter).

   The context contains the necessary information about the function version. The structure of this object is described in Invocation context.

A handler is a function that is declared in a global namespace and takes two arguments.

To have the execution result returned, use the return statement or throw an exception using the throw statement.

Examples

HTTP request structure output

The following function outputs the request structure and invocation context to both the execution log and function response:

<?php

function myHandler ($event, $context) {
    $resp = [
        'event' => $event,
        'context' => $context,
    ];

    return [
        'statusCode' => 200,
        'body' => json_encode($resp),
    ];
}

Synchronous handler

The function returns the available response or an error:

<?php

function myHandler ($event, $context) {
    $message = "not lucky";
    if (rand() % 2 == 0) {
        $message = "lucky one";
    }

    return [
        'statusCode' => 200,
        'headers' => [
            'Content-Type' => 'text/plain',
        ],
        'body' => $message,
    ];
}