Amazon SQS Queue

Queue-centric wrapper for Amazon Simple Queue Service

Version

2008.11.18

Copyright

2006-2009 LifeNexus Digital, Inc., and contributors.

License

Simplified BSD Licensehttp://opensource.org/licenses/bsd-license.php

See Also

Tarzanhttp://tarzan-aws.com
Amazon SQShttp://aws.amazon.com/sqs

Constants

SQSQUEUE_DEFAULT_ERROR

Specify the default error message.

AmazonSQSQueue

Container for all Amazon SQS-related methods.  Inherits additional methods from AmazonSQS.

Extends

AmazonSQS

Example Usage

require_once('tarzan.class.php');

// Instantiate a new AmazonSQS object using the settings from the config.inc.php file.
$sqs = new AmazonSQSQueue();

// Instantiate a new AmazonSQS object using these specific settings.
$sqs = new AmazonSQSQueue($key, $secret_key);

Properties

queue_url

The queue URL to use for every request.

Functions

__construct()

public function __construct($queue =  null,
$key =  null,
$secret_key =  null)

The constructor

Access

public

Parameters

queuestring (Optional) The NAME for the queue to revolve around.  Set as null if you plan to create a new queue, as it will be auto-set.
keystring (Optional) Your Amazon API Key.  If blank, it will look for the AWS_KEY constant.
secret_keystring (Optional) Your Amazon API Secret Key.  If blank, it will look for the AWS_SECRET_KEY constant.

Returns

boolean false if no valid values are set, otherwise true.

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/__construct.phps

create_queue()

public function create_queue($queue_name,  
$returnCurlHandle =  null)

Identical to AmazonSQS::create_queue().  The queue URL created from this method will replace the queue URL already being used with this class.

New queue URL will NOT automatically apply when using MultiCurl for parallel requests.

Access

public

Parameters

queue_nameSee AmazonSQS::create_queue().
returnCurlHandleSee AmazonSQS::create_queue().

Returns

TarzanHTTPResponse object

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/create_queue.phps

delete_queue()

public function delete_queue($returnCurlHandle =  null)

Identical to AmazonSQS::delete_queue(), except that you don’t need to pass in a queue URL.

Access

public

Parameters

returnCurlHandleSee AmazonSQS::delete_queue().

Returns

TarzanHTTPResponse object

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/delete_queue.phps

get_queue_attributes()

public function get_queue_attributes($returnCurlHandle =  null)

Identical to AmazonSQS::get_queue_attributes(), except that you don’t need to pass in a queue URL.

Access

public

Parameters

returnCurlHandleSee AmazonSQS::get_queue_attributes().

Returns

TarzanHTTPResponse object

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/get_queue_attributes.phps

set_queue_attributes()

public function set_queue_attributes($opt =  null)

Identical to AmazonSQS::set_queue_attributes(), except that you don’t need to pass in a queue URL.

Access

public

Parameters

optSee AmazonSQS::set_queue_attributes().

Returns

TarzanHTTPResponse object

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/set_queue_attributes.phps

send_message()

public function send_message($message,  
$returnCurlHandle =  null)

Identical to AmazonSQS::send_message(), except that you don’t need to pass in a queue URL.

Access

public

Parameters

messageSee AmazonSQS::send_message().
returnCurlHandleSee AmazonSQS::send_message().

Returns

TarzanHTTPResponse object

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/send_message.phps

receive_message()

public function receive_message($opt =  null)

Identical to AmazonSQS::receive_message(), except that you don’t need to pass in a queue URL.

Access

public

Parameters

optSee AmazonSQS::receive_message().

Returns

TarzanHTTPResponse object

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/receive_message.phps

delete_message()

public function delete_message($receipt_handle,  
$returnCurlHandle =  null)

Identical to AmazonSQS::delete_message(), except that you don’t need to pass in a queue URL.

Access

public

Parameters

receipt_handleSee AmazonSQS::delete_message().
returnCurlHandleSee AmazonSQS::delete_message().

Returns

TarzanHTTPResponse object

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/delete_message.phps

get_queue_size()

public function get_queue_size()

Identical to AmazonSQS::get_queue_size(), except that you don’t need to pass in a queue URL.

Access

public

Returns

integer The Approximate number of messages in the queue.

See Also

Example Usagehttp://tarzan-aws.com/docs/examples/sqsqueue/get_queue_size.phps