Oauth/Consumer.php
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 [email protected] so we can send you a copy immediately.
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Oauth
- Version
- $Id: Consumer.php 24593 2012-01-05 20:35:02Z matthew $
\Zend_Oauth_Consumer
- Parent(s)
- \Zend_Oauth
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Constants
REQUEST_SCHEME_HEADER
= 'header'- Inherited_from
- \Zend_Oauth::REQUEST_SCHEME_HEADER
REQUEST_SCHEME_POSTBODY
= 'postbody'- Inherited_from
- \Zend_Oauth::REQUEST_SCHEME_POSTBODY
REQUEST_SCHEME_QUERYSTRING
= 'querystring'- Inherited_from
- \Zend_Oauth::REQUEST_SCHEME_QUERYSTRING
OPTIONS
= 'OPTIONS'- Inherited_from
- \Zend_Oauth::OPTIONS
Properties

\Zend_Oauth_Token_Access $_accessToken = nullAccess token retrieved from OAuth Provider
nullDetails

\Zend_Oauth_Token_Request $_requestToken = nullRequest Token retrieved from OAuth Provider
nullDetails

\Zend_Http_Client $httpClient = nullSingleton instance if required of the HTTP client
Inherited from: \Zend_Oauth::$$httpClientnullDetails- Type
- \Zend_Http_Client
- Inherited_from
- \Zend_Oauth::$$httpClient
Methods

__call(string $method, array $args) : mixedSimple Proxy to the current Zend_Oauth_Config method.
It's that instance which holds all configuration methods and values this object also presents as it's API.
| Name | Type | Description |
|---|---|---|
| $method | string | |
| $args | array |
| Type | Description |
|---|---|
| mixed |
| Exception | Description |
|---|---|
| \Zend_Oauth_Exception | if method does not exist in config object |

__construct(array | \Zend_Config $options = null) : voidConstructor; create a new object with an optional array|Zend_Config instance containing initialising options.
| Name | Type | Description |
|---|---|---|
| $options | array | \Zend_Config |

clearHttpClient() : voidSimple mechanism to delete the entire singleton HTTP Client instance which forces an new instantiation for subsequent requests.
Inherited from: \Zend_Oauth::clearHttpClient()
getAccessToken(array $queryData, \Zend_Oauth_Token_Request $token, string $httpMethod = null, \Zend_Oauth_Http_AccessToken $request = null) : \Zend_Oauth_Token_AccessRetrieve an Access Token in exchange for a previously received/authorized Request Token.
| Name | Type | Description |
|---|---|---|
| $queryData | array | GET data returned in user's redirect from Provider |
| $token | \Zend_Oauth_Token_Request | Request Token information |
| $httpMethod | string | |
| $request | \Zend_Oauth_Http_AccessToken |
| Type | Description |
|---|---|
| \Zend_Oauth_Token_Access |
| Exception | Description |
|---|---|
| \Zend_Oauth_Exception | on invalid authorization token, non-matching response authorization token, or unprovided authorization token |

getHttpClient() : \Zend_Http_ClientReturn the singleton instance of the HTTP Client.
Inherited from: \Zend_Oauth::getHttpClient()Note that the instance is reset and cleared of previous parameters and Authorization header values.
| Type | Description |
|---|---|
| \Zend_Http_Client |

getLastAccessToken() : \Zend_Oauth_Token_AccessReturn whatever the last Access Token retrieved was while using the current Consumer instance.
| Type | Description |
|---|---|
| \Zend_Oauth_Token_Access |

getLastRequestToken() : \Zend_Oauth_Token_RequestReturn whatever the last Request Token retrieved was while using the current Consumer instance.
| Type | Description |
|---|---|
| \Zend_Oauth_Token_Request |

getRedirectUrl(null | array $customServiceParameters = null, null | \Zend_Oauth_Token_Request $token = null, null | \Zend_OAuth_Http_UserAuthorization $redirect = null) : stringAfter a Request Token is retrieved, the user may be redirected to the OAuth Provider to authorize the application's access to their protected resources - the redirect URL being provided by this method.
Once the user has authorized the application for access, they are redirected back to the application which can now exchange the previous Request Token for a fully authorized Access Token.
| Name | Type | Description |
|---|---|---|
| $customServiceParameters | null | array | |
| $token | null | \Zend_Oauth_Token_Request | |
| $redirect | null | \Zend_OAuth_Http_UserAuthorization |
| Type | Description |
|---|---|
| string |

getRequestToken(null | array $customServiceParameters = null, null | string $httpMethod = null, null | \Zend_Oauth_Http_RequestToken $request = null) : \Zend_Oauth_Token_RequestAttempts to retrieve a Request Token from an OAuth Provider which is later exchanged for an authorized Access Token used to access the protected resources exposed by a web service API.
| Name | Type | Description |
|---|---|---|
| $customServiceParameters | null | array | Non-OAuth Provider-specified parameters |
| $httpMethod | null | string | |
| $request | null | \Zend_Oauth_Http_RequestToken |
| Type | Description |
|---|---|
| \Zend_Oauth_Token_Request |

getToken() : \Zend_Oauth_Token_AccessAlias to self::getLastAccessToken()
| Type | Description |
|---|---|
| \Zend_Oauth_Token_Access |

redirect(null | array $customServiceParameters = null, null | \Zend_Oauth_Token_Request $token = null, null | \Zend_Oauth_Http_UserAuthorization $request = null) : voidRather than retrieve a redirect URL for use, e.g.
from a controller, one may perform an immediate redirect.
Sends headers and exit()s on completion.
| Name | Type | Description |
|---|---|---|
| $customServiceParameters | null | array | |
| $token | null | \Zend_Oauth_Token_Request | |
| $request | null | \Zend_Oauth_Http_UserAuthorization |

setHttpClient(\Zend_Http_Client $httpClient) : voidAllows the external environment to make Zend_Oauth use a specific Client instance.
Inherited from: \Zend_Oauth::setHttpClient()| Name | Type | Description |
|---|---|---|
| $httpClient | \Zend_Http_Client |