Skip to content
Php library for amazon echo (alexa) skill development.
Branch: master
Clone or download
Latest commit fd08ce5 Jun 13, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples #68 add default help request handler May 15, 2019
src Fix spacing Jun 12, 2019
test Create tests for geolocation Jun 12, 2019
.gitignore php-cs-fixer Dec 4, 2017
.php_cs.php fixes #38 Aug 16, 2018
.travis.yml Update .travis.yml Dec 10, 2018 fixes #38 Aug 16, 2018
LICENSE Update LICENSE Jan 2, 2019 Update Travis Dec 10, 2018
composer.json #68 cs fixes May 21, 2019
phpunit.xml.dist close #44 psr-4 namespaces for tests Aug 20, 2018

Build Status Coverage Status MIT Licence contributions welcome Scrutinizer Code Quality

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.

Install via composer

Require the package with composer:

composer require maxbeckers/amazon-alexa-php


Handle the request:

  • map request data to request object
  • validate request
  • handle request data
  • create response
  • send response

Map request data to request object

Map needed request headers and request body to Request.

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.

use MaxBeckers\AmazonAlexa\Validation\RequestValidator;
$validator = new RequestValidator();

Register request handlers

For different requests it's helpful to create different RequestHandlers.

use MaxBeckers\AmazonAlexa\RequestHandler\RequestHandlerRegistry;
$requestHandlerRegistry = new RequestHandlerRegistry();

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);

Create a new request handler

The new request handler must extend AbstractRequestHandler. In constructor set the supportedApplicationIds to your skill Ids.

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

Then implement the abstract supportsRequest-method.

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.

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.

$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.

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

Symfony Integration

There is also a symfony bundle on maxbeckers/amazon-alexa-bundle.

You can’t perform that action at this time.