Stomp::readFrame

stomp_read_frame

(PECL stomp >= 0.1.0)

Stomp::readFrame -- stomp_read_frameReads the next frame

Description

Object-oriented style (method):

publicStomp::readFrame(string$class_name = "stompFrame"): stompframe

Procedural style:

stomp_read_frame(resource$link): array

Reads the next frame. It is possible to instantiate an object of a specific class, and pass parameters to that class's constructor.

Parameters

link

Procedural style only: The stomp link identifier returned by stomp_connect().

class_name

The name of the class to instantiate. If not specified, a stompFrame object is returned.

Return Values

Note:

A transaction header may be specified, indicating that the message acknowledgment should be part of the named transaction.

Changelog

VersionDescription
Stomp 0.4.0class_name parameter was added.

Examples

Example #1 Object-oriented style

<?php


try {
$stomp = new Stomp('tcp://localhost:61613');
} catch(
StompException $e) {
die(
'Connection failed: ' . $e->getMessage());
}


$stomp->subscribe('/queue/foo');


var_dump($stomp->readFrame());


unset($stomp);

?>

The above example will output something similar to:

object(StompFrame)#2 (3) { ["command"]=> string(7) "MESSAGE" ["headers"]=> array(5) { ["message-id"]=> string(41) "ID:php.net-55293-1257226743606-4:2:-1:1:1" ["destination"]=> string(10) "/queue/foo" ["timestamp"]=> string(13) "1257226805828" ["expires"]=> string(1) "0" ["priority"]=> string(1) "0" } ["body"]=> string(3) "bar" }

Example #2 Procedural style

<?php


$link = stomp_connect('ssl://localhost:61612');


if (!$link) {
die(
'Connection failed: ' . stomp_connect_error());
}


stomp_subscribe($link, '/queue/foo');


$frame = stomp_read_frame($link);


stomp_close($link);

?>

The above example will output something similar to:

array(3) { ["command"]=> string(7) "MESSAGE" ["body"]=> string(3) "bar" ["headers"]=> array(6) { ["transaction"]=> string(2) "t1" ["message-id"]=> string(41) "ID:php.net-55293-1257226743606-4:3:-1:1:1" ["destination"]=> string(10) "/queue/foo" ["timestamp"]=> string(13) "1257227037059" ["expires"]=> string(1) "0" ["priority"]=> string(1) "0" } }
To Top