Class for connecting to queues performing common operations.

category Zend
package Zend_Queue
copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
license New BSD License

 Methods

Constructor

__construct($spec, \Zend_Config|array $options = array()) : void

Can be called as $queue = new Zend_Queue($config);

  • or - $queue = new Zend_Queue('array', $config);
  • or - $queue = new Zend_Queue(null, $config); // Zend_Queue->createQueue();

Parameters

$spec

$options

\Zend_Configarray

Zend_Config or a configuration array

Returns the approximate number of messages in the queue

count() : integer

Returns

integer

Create a new queue

createQueue(string $name, integer $timeout = null) : \Zend_Queue | false

Parameters

$name

string

queue name

$timeout

integer

default visibility timeout

Exceptions

\Zend_Queue_Exception

Returns

\Zend_Queuefalse

returns a listing of Zend_Queue details.

debugInfo() : array

useful for debugging

Returns

array

Delete a message from the queue

deleteMessage(\Zend_Queue_Message $message) : boolean

Returns true if the message is deleted, false if the deletion is unsuccessful.

Returns true if the adapter doesn't support message deletion.

Parameters

$message

\Zend_Queue_Message

Exceptions

\Zend_Queue_Exception

Returns

boolean

Delete the queue this object is working on.

deleteQueue() : boolean

This queue is disabled, regardless of the outcome of the deletion of the queue, because the programmers intent is to disable this queue.

Returns

boolean

Get the adapter for this queue

getAdapter() : \Zend_Queue_Adapter_AdapterInterface

Returns

\Zend_Queue_Adapter_AdapterInterface

Return a list of queue capabilities functions

getCapabilities() : array

$array['function name'] = true or false true is supported, false is not supported.

Returns

array

getMessageClass()

getMessageClass() : string

Returns

string

getMessageSetClass()

getMessageSetClass() : string

Returns

string

Get the name of the queue

getName() : string

Note: _setName() used to exist, but it caused confusion with createQueue Will evaluate later to see if we should add it back in.

Returns

string

Retrieve a single option

getOption(string $name) : null | mixed

Parameters

$name

string

Returns

nullmixedReturns null if option does not exist; option value otherwise

Returns the configuration options for the queue

getOptions() : array

Returns

array

Get an array of all available queues

getQueues() : array

Exceptions

\Zend_Queue_Exception

Returns

array

Determine if a requested option has been defined

hasOption(string $name) : boolean

Parameters

$name

string

Returns

boolean

Indicates if a function is supported or not.

isSupported(string $name) : boolean

Parameters

$name

string

Returns

boolean

Return the first element in the queue

receive(integer $maxMessages = null, integer $timeout = null) : \Zend_Queue_Message_Iterator

Parameters

$maxMessages

integer

$timeout

integer

Returns

\Zend_Queue_Message_Iterator

Send a message to the queue

send(mixed $message) : \Zend_Queue_Message

Parameters

$message

mixed

message

Exceptions

\Zend_Queue_Exception

Returns

\Zend_Queue_Message

Set the adapter for this queue

setAdapter(string|\Zend_Queue_Adapter_AdapterInterface $adapter) : \Zend_Queue

Parameters

$adapter

string\Zend_Queue_Adapter_AdapterInterface

Returns

\Zend_QueueProvides a fluent interface

setMessageClass()

setMessageClass(string $className) : \Zend_Queue

Parameters

$className

string

Returns

\Zend_QueueProvides a fluent interface

setMessageSetClass()

setMessageSetClass(string $className) : \Zend_Queue

Parameters

$className

string

Returns

\Zend_QueueProvides a fluent interface

Set an individual configuration option

setOption(string $name, mixed $value) : \Zend_Queue

Parameters

$name

string

$value

mixed

Returns

\Zend_Queue

Set queue options

setOptions(array $options) : \Zend_Queue

Parameters

$options

array

Returns

\Zend_Queue

Set the name of the queue

_setName(string $name) : \Zend_Queue | false

This is AN UNSUPPORTED FUNCTION

Parameters

$name

string

Returns

\Zend_QueuefalseProvides a fluent interface

 Properties

 

$_adapter

$_adapter : \Zend_Queue_Adapter_AdapterInterface

Default

null
 

$_logger

$_logger : \Zend_Log

Default

null
 

Zend_Queue_Message class

$_messageClass : string

Default

'Zend_Queue_Message'
 

Zend_Queue_Message_Iterator class

$_messageSetClass : string

Default

'Zend_Queue_Message_Iterator'
 

User-provided configuration

$_options : array

Default

array()

 Constants

 

Use the NAME constant in the config of Zend_Queue

NAME = 'name' 
 

Use the TIMEOUT constant in the config of a Zend_Queue

TIMEOUT = 'timeout' 
 

Default visibility passed to count

VISIBILITY_TIMEOUT = 30