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 = null
Access token retrieved from OAuth Provider
null
Details


\Zend_Oauth_Token_Request $_requestToken = null
Request Token retrieved from OAuth Provider
null
Details


\Zend_Http_Client $httpClient = null
Singleton instance if required of the HTTP client
Inherited from: \Zend_Oauth::$$httpClientnull
Details- Type
- \Zend_Http_Client
- Inherited_from
- \Zend_Oauth::$$httpClient
Methods


__call(string $method, array $args) : mixed
Simple 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) : void
Constructor; create a new object with an optional array|Zend_Config instance containing initialising options.
Name | Type | Description |
---|---|---|
$options | array | \Zend_Config |


clearHttpClient() : void
Simple 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_Access
Retrieve 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_Client
Return 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_Access
Return whatever the last Access Token retrieved was while using the current Consumer instance.
Type | Description |
---|---|
\Zend_Oauth_Token_Access |


getLastRequestToken() : \Zend_Oauth_Token_Request
Return 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) : string
After 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_Request
Attempts 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_Access
Alias 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) : void
Rather 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) : void
Allows the external environment to make Zend_Oauth use a specific Client instance.
Inherited from: \Zend_Oauth::setHttpClient()Name | Type | Description |
---|---|---|
$httpClient | \Zend_Http_Client |