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

ActiveLibrary

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

Composer library to query AWS SES notifications (SQS queues)

1.0.11(2y ago)039MITJavaScriptPHP &gt;= 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 1mo ago

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 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 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

923d 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

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[aws/aws-sdk-php-laravel

A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP.

1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[humanmade/s3-uploads

WordPress plugin to store uploads on S3

2.1k2.4M9](/packages/humanmade-s3-uploads)[bref/laravel-bridge

An advanced Laravel integration for Bref, including Octane support.

3384.1M11](/packages/bref-laravel-bridge)[magento/magento2-functional-testing-framework

Magento2 Functional Testing Framework

15511.5M30](/packages/magento-magento2-functional-testing-framework)[laravel-notification-channels/aws-sns

Amazon Simple Notification Service (AWS SNS) notification channel for Laravel.

541.1M2](/packages/laravel-notification-channels-aws-sns)

PHPackages © 2026

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