dmitrijs/amazon-alexa-php

Amazon Alexa interface for PHP

0.1.6 2017-08-23 09:59 UTC

Requires

• php: >=5.4.0

Requires (Dev)

• phpunit/phpunit: ~4.6

MIT

• Mathias Hansen
• Dmitrijs Sadovskis

README

This library provides provides a convient interface for developing Amazon Alexa Skills for your PHP app.

Usage

Install via composer: composer require minicodemonkey/amazon-alexa-php.

Requests

When Amazon Alexa triggers your skill, a HTTP request will be sent to the URL you specified for your app.

You can parse the JSON body of the request like so:

$jsonDataAsArray = $request->json()->all(); // This is how you would retrieve this with Laravel
$alexaRequest = \Alexa\Request\Request::fromData($jsonDataAsArray);

You can determine the type of the request with instanceof, e.g.:

if ($alexaRequest instanceof IntentRequest) {
	// Handle intent here
}

Response

You can build an Alexa response with the Response class. You can optionally set a card or a reprompt too.

Here's a few examples.

$response = new \Alexa\Response\Response;
$response->respond('Cooool. I\'ll lower the temperature a bit for you!')
	->withCard('Temperature decreased by 2 degrees');

$response = new \Alexa\Response\Response;
$response->respond('What is your favorite color?')
	->reprompt('Please tell me your favorite color');

Call dialogDelegate() to delegate response to Alexa Skills.

$response = new \Alexa\Response\Response;
$response->dialogDelegate();

To output the response, simply use the ->render() function, e.g. in Laravel you would create the response like so:

return response()->json($response->render());

In vanilla PHP:

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

TODO

• Verify request timestamp integrity automatically