maxbeckers/amazon-alexa-php

Php library for amazon echo (alexa) skill development.

Sunday, July 29, 2018
by maxbeckers
Repository
5 Watchers
24 Stars
856 Installations

PHP
1 Dependents
0 Suggesters
8 Forks
2 Open issues
33 Versions
65 % Grown

The README.md

, _(*1)

Amazon alexa php library

This library is a helper for amazon echo (alexa) skills with php. With this library it's very simple to handle alexa requests in your php application. You only create some handlers for the requests of your alexa skill and add them to a registry., _(*2)

Install via composer

Require the package with composer:, _(*3)

composer require maxbeckers/amazon-alexa-php

Usage

Handle the request: - map request data to request object - validate request - handle request data - create response - send response, _(*4)

Map request data to request object

Map needed request headers and request body to Request., _(*5)

use MaxBeckers\AmazonAlexa\Request\Request;
...
$requestBody  = file_get_contents('php://input');
$alexaRequest = Request::fromAmazonRequest($requestBody, $_SERVER['HTTP_SIGNATURECERTCHAINURL'], $_SERVER['HTTP_SIGNATURE']);

Validate request

The RequestValidator will handle the amazon request validation., _(*6)

use MaxBeckers\AmazonAlexa\Validation\RequestValidator;
...
$validator = new RequestValidator();
$validator->validate($alexaRequest);

Register request handlers

For different requests it's helpful to create different RequestHandlers., _(*7)

use MaxBeckers\AmazonAlexa\RequestHandler\RequestHandlerRegistry;
...
$requestHandlerRegistry = new RequestHandlerRegistry();
$requestHandlerRegistry->addHandler($myRequestHandler);

Use registry to handle request

use MaxBeckers\AmazonAlexa\RequestHandler\RequestHandlerRegistry;
...
$requestHandler = $requestHandlerRegistry->getSupportingHandler($alexaRequest);
$response       = $requestHandler->handleRequest($alexaRequest);

Render response

header('Content-Type: application/json');
echo json_encode($response);
exit();

Create a new request handler

The new request handler must extend AbstractRequestHandler. In constructor set the supportedApplicationIds to your skill Ids., _(*8)

public function __construct()
{
    $this->supportedApplicationIds = ['my_amazon_skill_id'];
}

Then implement the abstract supportsRequest-method., _(*9)

public function supportsRequest(Request $request): bool
{
    return $request->request instanceOf MaxBeckers\AmazonAlexa\Request\Request\Standard\IntentRequest &&
        'MyTestIntent' === $request->request->intent->name;
}

Then implement the handleRequest-method. For simple responses there is a ResponseHelper., _(*10)

use MaxBeckers\AmazonAlexa\Helper\ResponseHelper;
...
public function handleRequest(Request $request): Response
{
    return $this->responseHelper->respond('Success :)');
}

Check device address information

To get either "Full Address" or "Country & Postal Code" from the customer you need the permissions for user api call. More informations for the call see device-address-api., _(*11)

$helper = new DeviceAddressInformationHelper();
$fullAddress = $helper->getAddress($request);
$countryAndPostalCode = $helper->getCountryAndPostalCode($request);

Generate SSML

For SSML output you can use the SsmlGenerator. With the helper will generate valid SSML for alexa. All types of alexa known SSML tags have a function in the SsmlGeneator. You can add all SSML you need to the generator and call getSsml to get the full string., _(*12)

$ssmlGenerator = new SsmlGenerator();
$ssmlGenerator->say('one');
$ssmlGenerator->pauseStrength(SsmlGenerator::BREAK_STRENGTH_MEDIUM);
$ssmlGenerator->say('two');
$ssml = $ssmlGenerator->getSsml();
// $ssml === '<speak>one <break strength="medium" /> two</speak>'

Symfony Integration

There is also a symfony bundle on maxbeckers/amazon-alexa-bundle., _(*13)

The Versions

29/07 2018

dev-master

9999999-dev

Php library for amazon echo (alexa) skill development.

library amazon-alexa-php

Php library for amazon echo (alexa) skill development.

maxbeckers/amazon-alexa-php

The README.md

Amazon alexa php library

Install via composer

Usage

Map request data to request object

Validate request

Register request handlers

Use registry to handle request

Render response

Create a new request handler

Check device address information

Generate SSML

Symfony Integration

The Versions

dev-master

The Requires

The Development Requires

by Maximilian Beckers

1.2.1

The Requires

The Development Requires

by Maximilian Beckers

dev-develop

The Requires

The Development Requires

by Maximilian Beckers

1.2.0

The Requires

The Development Requires

by Maximilian Beckers

dev-feature/28

The Requires

The Development Requires

by Maximilian Beckers

1.1.3

The Requires

The Development Requires

by Maximilian Beckers

1.1.x-dev

The Requires

The Development Requires

by Maximilian Beckers

1.1.2

The Requires

The Development Requires

by Maximilian Beckers

1.1.1

The Requires

The Development Requires

by Maximilian Beckers

1.1.0

The Requires

The Development Requires

by Maximilian Beckers

1.0.16

The Requires

The Development Requires

by Maximilian Beckers

1.0.15

The Requires

The Development Requires

by Maximilian Beckers

1.0.14

The Requires

The Development Requires

by Maximilian Beckers

1.0.13

The Requires

The Development Requires

by Maximilian Beckers

1.0.12

The Requires

The Development Requires

by Maximilian Beckers

1.0.11

The Requires

The Development Requires