diff -r 5a6b6e770365 -r 68c69c656a2c web/lib/Zend/Feed/Pubsubhubbub/Subscriber.php --- a/web/lib/Zend/Feed/Pubsubhubbub/Subscriber.php Thu May 07 15:10:09 2015 +0200 +++ b/web/lib/Zend/Feed/Pubsubhubbub/Subscriber.php Thu May 07 15:16:02 2015 +0200 @@ -14,9 +14,9 @@ * * @category Zend * @package Zend_Feed_Pubsubhubbub - * @copyright Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com) + * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com) * @license http://framework.zend.com/license/new-bsd New BSD License - * @version $Id: Subscriber.php 24593 2012-01-05 20:35:02Z matthew $ + * @version $Id$ */ /** @@ -32,7 +32,7 @@ /** * @category Zend * @package Zend_Feed_Pubsubhubbub - * @copyright Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com) + * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com) * @license http://framework.zend.com/license/new-bsd New BSD License */ class Zend_Feed_Pubsubhubbub_Subscriber @@ -145,8 +145,8 @@ * options for the Subscriber without calling all supported setter * methods in turn. * - * @param array|Zend_Config $options Options array or Zend_Config instance - * @return void + * @param array|Zend_Config|null $config Options array or Zend_Config instance + * @throws Zend_Feed_Pubsubhubbub_Exception */ public function __construct($config = null) { @@ -158,7 +158,8 @@ /** * Process any injected configuration options * - * @param array|Zend_Config $options Options array or Zend_Config instance + * @param array|Zend_Config $config Options array or Zend_Config instance + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function setConfig($config) @@ -207,6 +208,7 @@ * event will relate * * @param string $url + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function setTopicUrl($url) @@ -225,6 +227,7 @@ * Set the topic URL (RSS or Atom feed) to which the intended (un)subscribe * event will relate * + * @throws Zend_Feed_Pubsubhubbub_Exception * @return string */ public function getTopicUrl() @@ -241,6 +244,7 @@ * Set the number of seconds for which any subscription will remain valid * * @param int $seconds + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function setLeaseSeconds($seconds) @@ -270,6 +274,7 @@ * this Subscriber * * @param string $url + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function setCallbackUrl($url) @@ -288,6 +293,7 @@ * Get the callback URL to be used by Hub Servers when communicating with * this Subscriber * + * @throws Zend_Feed_Pubsubhubbub_Exception * @return string */ public function getCallbackUrl() @@ -309,6 +315,7 @@ * order of occurance in the parameter list determines this preference. * * @param string $mode Should be 'sync' or 'async' + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function setPreferredVerificationMode($mode) @@ -339,6 +346,7 @@ * Add a Hub Server URL supported by Publisher * * @param string $url + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function addHubUrl($url) @@ -398,7 +406,8 @@ * Add authentication credentials for a given URL * * @param string $url - * @param array $authentication + * @param array $authentication + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function addAuthentication($url, array $authentication) @@ -452,8 +461,9 @@ /** * Add an optional parameter to the (un)subscribe requests * - * @param string $name + * @param string $name * @param string|null $value + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function setParameter($name, $value = null) @@ -483,8 +493,8 @@ /** * Add an optional parameter to the (un)subscribe requests * - * @param string $name - * @param string|null $value + * @param array $parameters + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function setParameters(array $parameters) @@ -499,6 +509,7 @@ * Remove an optional parameter for the (un)subscribe requests * * @param string $name + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Subscriber */ public function removeParameter($name) @@ -542,6 +553,7 @@ * to background save any verification tokens associated with a subscription * or other. * + * @throws Zend_Feed_Pubsubhubbub_Exception * @return Zend_Feed_Pubsubhubbub_Model_SubscriptionInterface */ public function getStorage() @@ -557,8 +569,6 @@ /** * Subscribe to one or more Hub Servers using the stored Hub URLs * for the given Topic URL (RSS or Atom feed) - * - * @return void */ public function subscribeAll() { @@ -568,8 +578,6 @@ /** * Unsubscribe from one or more Hub Servers using the stored Hub URLs * for the given Topic URL (RSS or Atom feed) - * - * @return void */ public function unsubscribeAll() { @@ -619,7 +627,8 @@ * Executes an (un)subscribe request * * @param string $mode - * @return void + * @throws Zend_Feed_Pubsubhubbub_Exception + * @throws Zend_Http_Client_Exception */ protected function _doRequest($mode) { @@ -669,7 +678,6 @@ /** * Get a basic prepared HTTP client for use * - * @param string $mode Must be "subscribe" or "unsubscribe" * @return Zend_Http_Client */ protected function _getHttpClient() @@ -686,7 +694,8 @@ * client's POST body that are specific to the current Hub Server URL * * @param string $hubUrl - * @param mode $hubUrl + * @param string $mode + * @throws Zend_Feed_Pubsubhubbub_Exception * @return string */ protected function _getRequestParameters($hubUrl, $mode) @@ -776,7 +785,6 @@ * requests to a Hub Server. Follows no particular method, which means * it might be improved/changed in future. * - * @param string $hubUrl The Hub Server URL for which this token will apply * @return string */ protected function _generateVerifyToken() @@ -791,6 +799,7 @@ * Simple helper to generate a verification token used in (un)subscribe * requests to a Hub Server. * + * @param array $params * @param string $hubUrl The Hub Server URL for which this token will apply * @return string */