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