PHPackages                             jakubsuchy/amazon-alexa-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. jakubsuchy/amazon-alexa-php

ActiveLibrary[API Development](/categories/api)

jakubsuchy/amazon-alexa-php
===========================

Amazon Alexa interface for PHP

0.1.7(9y ago)3629.3k↓50%14[2 PRs](https://github.com/jakubsuchy/amazon-alexa-php/pulls)MITPHPPHP >=5.3.0

Since Aug 26Pushed 8y ago5 watchersCompare

[ Source](https://github.com/jakubsuchy/amazon-alexa-php)[ Packagist](https://packagist.org/packages/jakubsuchy/amazon-alexa-php)[ RSS](/packages/jakubsuchy-amazon-alexa-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (13)Used By (0)

Amazon Alexa PHP Library
========================

[](#amazon-alexa-php-library)

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

Usage
-----

[](#usage)

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

### Requests

[](#requests)

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

You can get the `JSON` body of the request like so:

```
$applicationId = "your-application-id-from-alexa"; // See developer.amazon.com and your Application. Will start with "amzn1.echo-sdk-ams.app."
$rawRequest = $request->getContent; // This is how you would retrieve this with Laravel or Symfony 2.
$alexa = new \Alexa\Request\Request($rawRequest, $applicationId);
$alexaRequest = $alexa->fromData();
```

The library expect raw request data, not parsed JSON as it needs to validate the request signature.

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

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

### Certificate validation

[](#certificate-validation)

By default the system validates the request signature by fetching Amazon's signing certificate and decrypting the signature. You need CURL to be able to get the certificate. No caching is done but you can override the Certificate class easily if you want to implement certificate caching yourself based on what your app provides:

Here is a basic example:

```
class MyAppCertificate extends \Alexa\Request\Certificate {
  public function getCertificate() {
    $cached_certificate = retrieve_cert_from_myapp_cache();
    if (empty($cached_certificate)) {
      // Certificate is not cached, download it
      $cached_ertificate = $this->fetchCertificate();
      // Cache it now
    }
    return $cached_certificate;
  }
}
```

And then in your app, use the setCertificateDependency function:

```
$certificate = new MyAppCertificate($_SERVER['HTTP_SIGNATURECERTCHAINURL'], $_SERVER['HTTP_SIGNATURE']);

$alexa = new \Alexa\Request\Request($rawRequest);
$alexa->setCertificateDependency($certificate);

$alexaRequest = $alexa->fromData();
```

### Application Id validation

[](#application-id-validation)

The library will automatically validate your Application Id matches the one of the incoming request - you don't need to do anything for that. If and only if you wish to change how the validation happens, you might use a similar scenario to the certificate validation - provide your own Application class extending the \\Alexa\\Request\\Application and providing a validateApplicationId() function as part of that. Pass your application to the Request library in a same way as the certificate:

```
$application = new MyAppApplication($myappId);
$alexa = new \Alexa\Request\Request($rawRequest, $myappId);
$alexa->setApplicationDependency($application);

$alexaRequest = $alexa->fromData();
```

### Response

[](#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');
```

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

###  Health Score

36

—

LowBetter than 81% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity40

Moderate usage in the ecosystem

Community18

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 51.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~43 days

Recently: every ~82 days

Total

10

Last Release

3516d ago

PHP version history (2 changes)0.0.1PHP >=5.4.0

0.1.6PHP >=5.3.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/234124?v=4)[jakubsuchy](/maintainers/jakubsuchy)[@jakubsuchy](https://github.com/jakubsuchy)

---

Top Contributors

[![korra88](https://avatars.githubusercontent.com/u/5181309?v=4)](https://github.com/korra88 "korra88 (14 commits)")[![MiniCodeMonkey](https://avatars.githubusercontent.com/u/220535?v=4)](https://github.com/MiniCodeMonkey "MiniCodeMonkey (8 commits)")[![jakubsuchy](https://avatars.githubusercontent.com/u/234124?v=4)](https://github.com/jakubsuchy "jakubsuchy (3 commits)")[![chris-hamper](https://avatars.githubusercontent.com/u/12731598?v=4)](https://github.com/chris-hamper "chris-hamper (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jakubsuchy-amazon-alexa-php/health.svg)

```
[![Health](https://phpackages.com/badges/jakubsuchy-amazon-alexa-php/health.svg)](https://phpackages.com/packages/jakubsuchy-amazon-alexa-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M475](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M270](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M186](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M33](/packages/facebook-php-business-sdk)[microsoft/microsoft-graph

The Microsoft Graph SDK for PHP

65723.5M95](/packages/microsoft-microsoft-graph)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)