PHPackages                             growler/growler - 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. [Utility & Helpers](/categories/utility)
4. /
5. growler/growler

AbandonedArchivedLibrary[Utility & Helpers](/categories/utility)

growler/growler
===============

Growl binding for PHP

13101PHP

Since Jan 22Pushed 14y agoCompare

[ Source](https://github.com/roccozanni/growler)[ Packagist](https://packagist.org/packages/growler/growler)[ RSS](/packages/growler-growler/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Growler - A pure PHP Growl notification library
===============================================

[](#growler---a-pure-php-growl-notification-library)

[![Build Status](https://camo.githubusercontent.com/6c83fee40e48670e0fbf3f96a3fc2f51429acf849498349cec1c6c739c363e4e/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f726f63636f7a616e6e692f67726f776c65722e706e67)](http://travis-ci.org/roccozanni/growler)

Class loading
-------------

[](#class-loading)

If you have installed the package with composer, it will provide autoloading feature:

```
require_once 'vendor/.composer/autoload.php';

```

Otherwise, if you already use in your project a PSR-0 compliant autoloader, simply register the "Growler" namespace:

```
// This is based on the Symfony2 Class Loader
$loader->registerNamespace('Growler', 'growler/src');

```

Otherwise, a basic autoloader is included in the Growler distribution:

```
require_once 'growler/src/Growler/ClassLoader.php';
Growler\ClassLoader::register();

```

UDP protocol
------------

[](#udp-protocol)

Historical versions of Growl (< 1.3), listen to the UDP port 9887 for incoming messages that represents notifications to display

The protocol is very simple:

- supports only title and message, no custom icon
- on the same socket you can send as many messages as you want, no response from the other side

The UDP procol implementation is feature-complete.

This is an example for creating a UDP based transport:

```
$connection  = new Growler\Connection("udp", "localhost", 9887);
$transport   = new Growler\Transport\Udp($connection);

```

GNTP protocol
-------------

[](#gntp-protocol)

From Growl 1.3 has been introduced the new TCP-based GNTP protocol.

GNTP is a protocol to allow two-way communication between applications and centralized notification systems such as Growl for Mac OS X and to allow two-way communication between two machines running centralized notification systems for notification forwarding purposes.

Missing GNTP features:

- Message encryption. In the current version of Growl (1.3.2), encryption is not supported yet. Is only defined in the protocol specification
- Subscribing and callbacks.

This is an example for creating a GNTP based transport:

```
$connection  = new Growler\Connection("tcp", "localhost", 23053);
$transport   = new Growler\Transport\Gntp($connection);

```

Password protection
-------------------

[](#password-protection)

Either the UDP and the GNTP protocols, support server password. Just add the password as the second parameter in transport creation:

```
$transport   = new Growler\Transport\Gntp($connection, "secret");

```

Other TODOs
-----------

[](#other-todos)

- Error handling
- A Facade for simpler use out-of-the-box

Examples
--------

[](#examples)

Code samples are available in the "examples" directory

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/5bd426076187a280aab3e0c7d9562eb5b6ed03212243c8a7de662ec97269ebc1?d=identicon)[rocco.zanni](/maintainers/rocco.zanni)

---

Top Contributors

[![roccozanni](https://avatars.githubusercontent.com/u/41727?v=4)](https://github.com/roccozanni "roccozanni (17 commits)")

### Embed Badge

![Health badge](/badges/growler-growler/health.svg)

```
[![Health](https://phpackages.com/badges/growler-growler/health.svg)](https://phpackages.com/packages/growler-growler)
```

###  Alternatives

[riverskies/laravel-vue-component

Helper package to aid usage of Vue Components within Laravel projects

201.2k](/packages/riverskies-laravel-vue-component)

PHPackages © 2026

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