Zend Framework
LICENSE
This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.
array $_asyncHubs = 'array'
An array of Hub Server URLs for Hubs operating at this time in asynchronous verification mode.
array $_authentications = 'array'
An array of authentication credentials for HTTP Basic Authentication if required by specific Hubs. The array is indexed by Hub Endpoint URI and the value is a simple array of the username and password to apply.
string $_callbackUrl = ''
The URL Hub Servers must use when communicating with this Subscriber
array $_errors = 'array'
An array of any errors including keys for 'response', 'hubUrl'.
The response is the actual Zend_Http_Response object.
array $_hubUrls = 'array'
An array of URLs for all Hub Servers to subscribe/unsubscribe.
int $_leaseSeconds = 'null'
The number of seconds for which the subscriber would like to have the subscription active. Defaults to null, i.e. not sent, to setup a permanent subscription if possible.
array $_parameters = 'array'
An array of optional parameters to be included in any (un)subscribe requests.
string $_preferredVerificationMode = 'Zend_Feed_Pubsubhubbub'
The preferred verification mode (sync or async). By default, this Subscriber prefers synchronous verification, but is considered desireable to support asynchronous verification if possible.
Zend_Feed_Pubsubhubbub_Subscriber will always send both modes, whose order of occurance in the parameter list determines this preference.
Zend_Feed_Pubsubhubbub_Model_SubscriptionInterface $_storage = 'null'
An instance of Zend_Feed_Pubsubhubbub_Model_SubscriptionInterface used to background save any verification tokens associated with a subscription or other.
$_testStaticToken = 'null'
This is STRICTLY for testing purposes only...
string $_topicUrl = ''
The URL of the topic (Rss or Atom feed) which is the subject of our current intent to subscribe to/unsubscribe from updates from the currently configured Hub Servers.
string $_usePathParameter = 'false'
Tells the Subscriber to append any subscription identifier to the path of the base Callback URL. E.g. an identifier "subkey1" would be added to the callback URL "http://www.example.com/callback" to create a subscription specific Callback URL of "http://www.example.com/callback/subkey1".
This is required for all Hubs using the Pubsubhubbub 0.1 Specification. It should be manually intercepted and passed to the Callback class using Zend_Feed_Pubsubhubbub_Subscriber_Callback::setSubscriptionKey(). Will require a route in the form "callback/:subkey" to allow the parameter be retrieved from an action using the Zend_Controller_Action::_getParam() method.
__construct(
$config
=
null
)
:
void
Constructor; accepts an array or Zend_Config instance to preset options for the Subscriber without calling all supported setter methods in turn.
_doRequest(
string $mode
)
:
void
Executes an (un)subscribe request
_generateSubscriptionKey(
$params, string $hubUrl
)
:
string
Simple helper to generate a verification token used in (un)subscribe requests to a Hub Server.
_generateVerifyToken(
)
:
string
Simple helper to generate a verification token used in (un)subscribe requests to a Hub Server. Follows no particular method, which means it might be improved/changed in future.
_getHttpClient(
)
:
Zend_Http_Client
Get a basic prepared HTTP client for use
_getRequestParameters(
string|mode $hubUrl, $mode
)
:
string
Return a list of standard protocol/optional parameters for addition to client's POST body that are specific to the current Hub Server URL
_toByteValueOrderedString(
array $params
)
:
array
Order outgoing parameters
_urlEncode(
array $params
)
:
array
URL Encode an array of parameters
addAuthentication(
string $url, array $authentication
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Add authentication credentials for a given URL
addAuthentications(
array $authentications
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Add authentication credentials for hub URLs
addHubUrl(
string $url
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Add a Hub Server URL supported by Publisher
addHubUrls(
array $urls
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Add an array of Hub Server URLs supported by Publisher
getAsyncHubs(
)
:
array
Return an array of Hub Server URLs who returned a response indicating operation in Asynchronous Verification Mode, i.e. they will not confirm any (un)subscription immediately but at a later time (Hubs may be doing this as a batch process when load balancing)
getAuthentications(
)
:
array
Get all hub URL authentication credentials
getCallbackUrl(
)
:
string
Get the callback URL to be used by Hub Servers when communicating with this Subscriber
getErrors(
)
:
array
Return an array of errors met from any failures, including keys: 'response' => the Zend_Http_Response object from the failure 'hubUrl' => the URL of the Hub Server whose notification failed
getHubUrls(
)
:
array
Return an array of unique Hub Server URLs currently available
getLeaseSeconds(
)
:
int
Get the number of lease seconds on subscriptions
getParameters(
)
:
array
Return an array of optional parameters for (un)subscribe requests
getPreferredVerificationMode(
)
:
string
Get preferred verification mode (sync or async).
getStorage(
)
:
Zend_Feed_Pubsubhubbub_Model_SubscriptionInterface
Gets an instance of Zend_Feed_Pubsubhubbub_Storage_StorageInterface used to background save any verification tokens associated with a subscription or other.
getTopicUrl(
)
:
string
Set the topic URL (RSS or Atom feed) to which the intended (un)subscribe event will relate
isSuccess(
)
:
bool
Returns a boolean indicator of whether the notifications to Hub Servers were ALL successful. If even one failed, FALSE is returned.
removeHubUrl(
string $url
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Remove a Hub Server URL
removeParameter(
string $name
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Remove an optional parameter for the (un)subscribe requests
setCallbackUrl(
string $url
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Set the callback URL to be used by Hub Servers when communicating with this Subscriber
setConfig(
$config
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Process any injected configuration options
setLeaseSeconds(
int $seconds
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Set the number of seconds for which any subscription will remain valid
setParameter(
string $name, string|null $value
=
null
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Add an optional parameter to the (un)subscribe requests
setParameters(
$parameters
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Add an optional parameter to the (un)subscribe requests
setPreferredVerificationMode(
string $mode
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Set preferred verification mode (sync or async). By default, this Subscriber prefers synchronous verification, but does support asynchronous if that's the Hub Server's utilised mode.
Zend_Feed_Pubsubhubbub_Subscriber will always send both modes, whose order of occurance in the parameter list determines this preference.
setStorage(
Zend_Feed_Pubsubhubbub_Model_SubscriptionInterface $storage
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Sets an instance of Zend_Feed_Pubsubhubbub_Model_SubscriptionInterface used to background save any verification tokens associated with a subscription or other.
setTestStaticToken(
$token
)
:
setTopicUrl(
string $url
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Set the topic URL (RSS or Atom feed) to which the intended (un)subscribe event will relate
subscribeAll(
)
:
void
Subscribe to one or more Hub Servers using the stored Hub URLs for the given Topic URL (RSS or Atom feed)
unsubscribeAll(
)
:
void
Unsubscribe from one or more Hub Servers using the stored Hub URLs for the given Topic URL (RSS or Atom feed)
usePathParameter(
bool $bool
=
true
)
:
Zend_Feed_Pubsubhubbub_Subscriber
Set flag indicating whether or not to use a path parameter