Services_Amazon_SQS
[ class tree: Services_Amazon_SQS ] [ index: Services_Amazon_SQS ] [ all elements ]
Packages:
Services_Amazon_SQS


Classes:
Services_Amazon_SQS
Services_Amazon_SQS_Account
Services_Amazon_SQS_ChecksumException
Services_Amazon_SQS_CLI
Services_Amazon_SQS_ErrorException
Services_Amazon_SQS_Exception
Services_Amazon_SQS_HttpException
Services_Amazon_SQS_InvalidAttributeException
Services_Amazon_SQS_InvalidMessageException
Services_Amazon_SQS_InvalidPermissionLabelException
Services_Amazon_SQS_InvalidQueueException
Services_Amazon_SQS_InvalidTimeoutException
Services_Amazon_SQS_Queue
Services_Amazon_SQS_QueueManager
Services_Amazon_SQS_Response
Files:
Account.php
CLI.php
Exceptions.php
Queue.php
QueueManager.php
Response.php
SQS.php

Class: Services_Amazon_SQS

Source Location: /Services_Amazon_SQS-0.3.0/Services/Amazon/SQS.php

Class Overview




Abstract base class for interfacing with Amazon Simple Queue Service (SQS)  queues




Author(s):






              
                      


Copyright:


    
  
  • 2008 Mike Brittain, 2008 Amazon.com, 2008 silverorange
    • 







Variables






Methods















Child classes:






Services_Amazon_SQS_QueueManager

	
Class for creating, managing, and deleting Amazon Simple Queue Service  (SQS) queues






Services_Amazon_SQS_Queue

	
A queue in the Amazon SQS









Inherited Variables





Inherited Methods














Class Details



[line 93]

Abstract base class for interfacing with Amazon Simple Queue Service (SQS)  queues
This class uses the HTTP query mechanism for accessing the Amazon SQS. See  page 20 of the Amazon SQS Developer's Guide PDF for details about the HTTP  query mechanism.









[ Top ]







Class Variables



	
	

	
$account =  null

	
[line 127]

  The account to use


    

  • Access: protected
    • 





  

	

  

    

      Type:  
      Services_Amazon_SQS_Account
    

      

	



	
[ Top ]


	
	

	
$maximumRetries =  10

	
[line 151]

  The maximum number of retries to make when encountering internal errors  on SQS





  

	

  

    

      Type:  
      integer
    

      

	



	
[ Top ]


	
	

	
$request =  null

	
[line 141]

  The HTTP request object to use
This can be specified in the constructor. Note: The request object is  only used as a template to create other request objects. This prevents  one API call from affecting the state of the HTTP request object for  subsequent API calls.





  

	

  

    

      Type:  
      HTTP_Request2
    

      

	



	
[ Top ]










Method Detail



	
	
addRequiredParameters   [line 349]

	

    

    

		array addRequiredParameters(

$parameters)
    

    


	
		Adds required authentication and version parameters to an array of  parameters
The required parameters are:
  • AWSAccessKey,
  • Timestamp, and
  • Version.
  If a required parameter is already set in the $parameters  array, it is not overwritten.


    

  • Return: the parameters array, which includes the required                parameters.
    • 

  • Access: protected
    • 








        
Parameters:

    

    

          

        array  
        $parameters  
        —
          the array to which to add the required                           parameters.
      

        

    


        
[ Top ]

  

  
  
	
	
getRequestBackoffTime   [line 478]

	

    

    

		integer getRequestBackoffTime(
integer
$count)
    

    


	
		Gets the number of milliseconds to wait before the next reqeust when  performing exponential backoff
Exponential backoff is used when SQS encounters internal errors.


    

  • Return: the number of milliseconds to delay before the next                  request is attempted.
    • 

  • Access: protected
    • 








        
Parameters:

    

    

          

        integer  
        $count  
        —
          the number of the current attempt. Zero based.
      

        

    


        
[ Top ]

  

  
  
	
	
__construct (Constructor)   [line 172]

	

    

    

		Services_Amazon_SQS __construct(
Services_Amazon_SQS_Account|string
$accessKey, [string
$secretAccessKey = ''], [
$request = null])
    

    


	
		Creates a new SQS client


    

  • Access: public
    • 







	
Overridden in child classes as:

		

	
Services_Amazon_SQS_Queue::__construct()

		
Creates a PHP SQS queue object

	

	


        
Parameters:

    

    

          

        Services_Amazon_SQS_Account|string  
        $accessKey  
        —
          either a         Services_Amazon_SQS_Account object or a string containing         the SQS access key for an account.
      

          

        string  
        $secretAccessKey  
        —
          if the first         parameter is an account object, this parameter is ignored.         Otherwise, this parameter is required and is the secret access         key for the SQS account.
      

          

        HTTP_Request2  
        $request  
        —
          optional. The         HTTP request object to use. If not specified, a HTTP request         object is created automatically.
      

        

    


        
[ Top ]

  

  
  
	
	
isValidPermissionLabel   [line 453]

	

    

    

		boolean isValidPermissionLabel(
string
$label)
    

    


	
		Gets whether or not a permission label is valid
Amazon SQS permission labels must conform to the following rules: 
  • must be 1 to 80 ASCII characters
  • must contain only alphanumeric characters, dashes (-), and
   underscores (_).


    

  • Return: true if the permission label is valid, otherwise false.
    • 

  • Access: protected
    • 








        
Parameters:

    

    

          

        string  
        $label  
        —
          the permission label to check.
      

        

    


        
[ Top ]

  

  
  
	
	
isValidVisibilityTimeout   [line 427]

	

    

    

		boolean isValidVisibilityTimeout(
integer
$timeout)
    

    


	
		Gets whether or not a visibility timeout is valid
Visibility timeouts must be between 0 and 7200 seconds.


    

  • Return: true if the timeout is valid, otherwise false.
    • 

  • Access: protected
    • 








        
Parameters:

    

    

          

        integer  
        $timeout  
        —
          the timeout value to check (in seconds).
      

        

    


        
[ Top ]

  

  
  
	
	
sendRequest   [line 264]

	

    

    

		mixed sendRequest(
[
$params = array()], [string
$queueUrl = null])
    

    


	
		Sends a HTTP request to the queue service
The supplied $params array should contain only the specific  parameters for the request type and should not include account,  signature, or timestamp related parameters. These parameters are added  automatically.


    

  • Return: Services_Amazon_SQS_Response object or false if the                request failed.
    • 

  • Throws: Services_Amazon_SQS_ErrorException if one or more errors are          returned from Amazon.
    • 

  • Throws: Services_Amazon_SQS_HttpException if the HTTP request fails.
    • 

  • Access: protected
    • 








        
Parameters:

    

    

          

        array  
        $params  
        —
          optional. Array of request parameters for the                          API call.
      

          

        string  
        $queueUrl  
        —
          optional. The specific queue URL for which                          the request is made. Does not need to be                          specified for general actions like listing                          queues.
      

        

    


        
[ Top ]

  

  
  
	
	
setMaximumRetries   [line 233]

	

    

    

		void setMaximumRetries(
integer
$retries)
    

    


	
		Sets the maximum number of retries to make when encountering internal  errors on SQS
Internal errors are handled using an exponential backoff algorithm so  take care not to set this number too high. For example, a request  requiring 20 retries will take approximately 17 minutes and 30 seconds  to complete. Any number less than 10 is generally acceptable, incurring  a maximum delay of just over 1 second.
The default value for Services_Amazon_SQS is 10 retries. Set to 0 to  turn off exponential backoff altogether.


    

  • Access: public
    • 








        
Parameters:

    

    

          

        integer  
        $retries  
        —
          the maximum number of retries to make when                          encountering internal errors on SQS.
      

        

    


        
[ Top ]

  

  
  
	
	
setRequest   [line 207]

	

    

    

		void setRequest(

$request)
    

    


	
		Sets the HTTP request object to use


    

  • Access: public
    • 








        
Parameters:

    

    

          

        HTTP_Request2  
        $request  
        —
          the HTTP request object to use.
      

        

    


        
[ Top ]

  

  
  
	
	
signParameters   [line 383]

	

    

    

		array signParameters(

$parameters, string
$secretKey, string
$url)
    

    


	
		Signs an array of request parameters using the Amazon Web Services  Signature Version 2 signing method








        
Parameters:

    

    

          

        array  
        $parameters  
        —
          the parameters for which to get the signature.
      

          

        string  
        $secretKey  
        —
          the secret key to use to sign the parameters.
      

          

        string  
        $url  
        —
          the request URI.
      

        

    


        
[ Top ]

  

  
  



        

		    

		    Documentation generated on Tue, 24 Nov 2009 17:00:05 +0000 by phpDocumentor 1.4.3. PEAR Logo Copyright ©  PHP Group 2004.