PHPackages                             net-tools/aws-ses-gui-notifications - 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. net-tools/aws-ses-gui-notifications

ActiveLibrary[API Development](/categories/api)

net-tools/aws-ses-gui-notifications
===================================

Composer library to query AWS SES notifications (SQS queues)

1.0.11(2y ago)039MITJavaScriptPHP >= 8.1.0

Since Jul 23Pushed 2y ago1 watchersCompare

[ Source](https://github.com/net-tools/aws-ses-gui-notifications)[ Packagist](https://packagist.org/packages/net-tools/aws-ses-gui-notifications)[ RSS](/packages/net-tools-aws-ses-gui-notifications/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (13)Used By (0)

net-tools/aws-ses-gui-notifications
===================================

[](#net-toolsaws-ses-gui-notifications)

PHP and Javascript interface to query AWS SES notifications
-----------------------------------------------------------

[](#php-and-javascript-interface-to-query-aws-ses-notifications)

When using AWS SES, it's possible to set bounce and delivery feedback to be published through a SNS topic. When a SQS queue has subscribed to the SNS topic, it will contain any bounce or delivery messages created during SES *send* action.

This library abstracts most of AWS API-related stuff and deals with GUI output.

How to use
----------

[](#how-to-use)

### Client-side Javascript

[](#client-side-javascript)

First, include the javascript `api.js.min` file in the web page.

Then, create the API object and execute the request, providing any required parameters :

- `nodeId` is a string set to a DOM tree element `id` value ; this element will contain the output
- `type` is a string setting the kind of SES data we fetch : Delivery or Bounce
- `cssClass` may be set with any CSS class names, making it possible to custom styling the output table

```
// creating API object
var req = new nettools.awsSesGuiNotifications(nodeId, type, cssClass);

// execute request and update GUI
req.update(
	// callback that must return a Promise object resolved with SQS data (see server-side remark below)
	function()
	{
		return fetch('/path/to/a/script.php', {
			method : 'POST'
		})
		.then(function(response){
			return response.json();
		});
	},

	// updates count (see remark below)
	5
);
```

Remarks :

- SQS queues may not return all messages in a single API call ; so it's necessary to perform several request to be sure to have all data.
- Create a server-side PHP file that will perform the AWS API call through our library and return the messages to the Javascript class.

### Server-side PHP

[](#server-side-php)

The server-side PHP file (refered above as `/path/to/a/script.php` must call our API to send the request to AWS SQS :

```
// creating Request object
$rq = new \Nettools\AwsSesGuiNotifications\Request(\Aws\Credentials\CredentialProvider::ini('default', '/path/to/aws/credentials'), $region);

// perform API call ; set $url_of_sqs_queue with the correct URL of the SQS queue to be queried
$ret = $rq->execute($url_of_sqs_queue);

// answer with json data
header("Content-Type: application/json; charset=utf-8");
echo json_encode($ret);
```

Please note that the `CredentialProvider::ini` call must define a path to a credentials file, and that `$region` must be a string setting the correct AWS region.

The credentials file must contains the following lines, with your key and secrets :

```
[default]
aws_access_key_id = ___key_here___
aws_secret_access_key = ___secret_here___

```

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~9 days

Recently: every ~25 days

Total

12

Last Release

976d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2cb0c1d404c8ae72b0a731246130079c2f440d6ea079815ca8c153aa361b1f28?d=identicon)[nettools.ovh](/maintainers/nettools.ovh)

---

Top Contributors

[![net-tools](https://avatars.githubusercontent.com/u/6818724?v=4)](https://github.com/net-tools "net-tools (14 commits)")

### Embed Badge

![Health badge](/badges/net-tools-aws-ses-gui-notifications/health.svg)

```
[![Health](https://phpackages.com/badges/net-tools-aws-ses-gui-notifications/health.svg)](https://phpackages.com/packages/net-tools-aws-ses-gui-notifications)
```

###  Alternatives

[keboola/storage-api-client

Keboola Storage API PHP Client

10405.9k40](/packages/keboola-storage-api-client)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45444.2k1](/packages/pressbooks-pressbooks)[ellaisys/aws-cognito

Laravel Authentication using AWS Cognito (Web and API)

123256.9k1](/packages/ellaisys-aws-cognito)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.7k1](/packages/jasara-php-amzn-selling-partner-api)[altis/core

Core module for Altis

19228.0k3](/packages/altis-core)[sproutcms/cms

Enterprise content management and framework

242.5k4](/packages/sproutcms-cms)

PHPackages © 2026

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