Send notifications to Growl from PHP on MACOSX and WINDOWS.

2013-01-29: Net_Growl 2.7.0 Released

Release highlights:

  • Support Icon Collections with archive streams like ZIP or PHAR

Read the CHANGELOG for a full list of all additions, changes and bug fixes. Changes are documented in the updated User Guide. See the Installation page for downloads and installation instructions.

Laurent Laville

Net_Growl is a PHP Library that makes it possible to easily send a notification from your PHP script to Growl.

Until now there were many UDP PHP implementations, but none for the new Growl Notification Transport Protocol (GNTP) - v1.0

I’ve decided to enlarge work begun by Bertrand Mansion with the PEAR::Net_Growl package (v 0.7.0).

While you can find some old compatible PHP4 versions (0.8.0b1, 0.9.0b1, 0.9.0b2), I’ve decided, with final stable version 2.0.0, to drop support of PHP4.

I’m focus now on a unique PHP5 library that includes all features of GNTP 1.0

Two different protocols may be used: the basic UDP (compatible with all platforms), and the new one GNTP.

The major version 2 is a full rewrites to PHP5, that used exceptions to raise errors.

Caution Its recommanded to migrate to PHP5, because PHP4 version is not maintained anymore.


Net_Growl provides :

UDP is limited to some features :

  • Application and notification icons are not provided by PHP scripts.

  • Callbacks are not supported.

GNTP is better than UDP :

  • Application and notification icons may be provided by PHP scripts.

  • Callbacks may be supported. (not yet with Net_Growl beta1)

  • Different Hash and Encryption backend : MD5, SHA1 (for version 0.9.0b1) plus SHA256 and SHA512 (for version 2.0.0b1)

Log framework used with version 0.9.0b1 is PEAR::Log package. While versions since 2.0.0b1 uses no particular log framework (basic text file I/O).

Both versions may send notifications without to call the Net_Growl::register() function. Net_Growl will do it for you at first notification.

If Application and Notification icons are invalid or not reachable, Net_Growl display the default Growl Logo.

Note since version 2.7.0, you have ability to define the default growl icon to use (see defaultIcon option), and its location (see resourceDir option).


Mac OSX platform :
  • Growl requires Mac OS X 10.5 or higher.

Windows platform :
  • Growl for Windows is a Windows-compatible version of Growl, a notification system for Mac OS X.

Mandatory resources :
  • PHP 5.2.0 or newer

  • pcre extension

  • SPL extension

  • hash extension requires no external libraries and is enabled by default as of PHP 5.1.2

Optional resources :
  • mcrypt extension when using GNTP adapter and encryt feature

Head to the Net_Growl User Guide available online for information or examples to get started.

The Net_Growl book is available in a selection of formats. You can download the documentation for offline reading.

Language Single HTML file Many HTML files HTML Help file PDF A4 file PDF US file EPUB file
English 237Kb 75Kb 82Kb netgrowl-book-a4.pdf 210Kb netgrowl-book-us.pdf 210Kb 66Kb


If you are in trouble, perhaps this page will give you a solution.


You want to learn more about previous versions. Read the full changelog.


You are free to do whatever you want, even in a commercial environment. You are also encouraged to contribute. Read the full license.


I would like to thanks here specially two guys without who this PHP version won’t be born.

Original author of PEAR::Net_Growl, that gave me hope to use one day the package on Windows platform. Bertrand Mansion

Author of Growl for Windows, that make the dream a reality for all Windows users. He also help me a lot to finalize the authorization part and encryption messages. Brian Dunnington

And of course, a special thanks to

Growl Team without who, this adventure wouldn’t be true. Growl Team

All pages of this site, and user guide were generated with AsciiDoc 8.6.8, assisted by FOP 1.0 (for PDFs). Automated build process uses Phing 2.4.14

Convert the HTML Help source (.hhp and .html) files to HTML Help (.chm) files using the Microsoft HTML Help Compiler.