Stomp PHP

This project is a PHP Stomp Client that besides it implements the Stomp protocol fully, adds some ActiveMQ specific features that could make your messaging from PHP easier.

Version choice

For new projects you should use version 3.* which is the last php-5.3 compatible.
For running projects with fusesource/stomp-php@2.x clients you can use version 2.2.2.
All version newer that 2.x won't be compatible with fusesource/stomp-php. (https://github.com/dejanb/stomp-php.)

Installing

The source is PSR-0 compliant. So just download the source and add the Namespace "Stomp" to your autoloader configuration with the path pointing to src/.

As an alternate you have the possibility to make use of composer to manage your project dependencies.

Just add

    "require": {
        "stomp-php/stomp-php": "3.*"
    }

to your project composer.json.

Or simply run composer require stomp-php/stomp-php in your project home.

Replace

If you used fusesource/stomp-php before, you can use our 2.x versions.

    "require": {
        "stomp-php/stomp-php": "2.*"
    }

Documentation

See our wiki.

Running Examples

Examples are located in src/examples folder. Before running them, be sure you have installed this library properly and you have started ActiveMQ broker (recommended version 5.5.0 or above) with [Stomp connector enabled] (http://activemq.apache.org/stomp.html).

You can start by running

cd examples
php connectivity.php

Also, be sure to check comments in the particular examples for some special configuration steps (if needed).

Step by Step: Certificate based Authentication

https://github.com/rethab/php-stomp-cert-example

Tests

To run the tests you first need to fetch the dependencies for the test suite via composer:

$ php composer.phar install

The functional testsuite is divided into three broker versions. Currently it's running on ActiveMq (Port 61010), Apollo (61020), RabbitMq (61030). Apollo should be configured to use admin:password and RabbitMq to guest:guest. While ActiveMq must be configured to use no login at all.

You can setup all brokers by running travis/bin/ci/setup.sh. Stop them by travis/bin/ci/stop.sh. Used version can be configured at travis/(BROKER)_VERSION.

You can use travis/bin/ci/clean.sh to reset the test environment.

If you only like to run the functional generic tests, ensure Apollo is configured.

Licence

Apache License Version 2.0

phpwutz/stomp-php