PECL OAuth documentation

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@272335 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
John Jawed 2008-12-31 00:38:41 +00:00
parent 7f6f33d595
commit 3f6168352c
18 changed files with 1368 additions and 0 deletions

47
reference/oauth/book.xml Normal file
View file

@ -0,0 +1,47 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- Purpose: webservice -->
<!-- Membership: pecl, external -->
<book xml:id="book.oauth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>OAuth</title>
<preface xml:id="intro.oauth">
&reftitle.intro;
<para>
This extension provides OAuth consumer bindings. OAuth is an
authorization protocol built on top of HTTP which allows applications
to securely access data without having to store usernames and
passwords.
</para>
</preface>
&reference.oauth.setup;
&reference.oauth.constants;
&reference.oauth.reference;
&reference.oauth.oauth;
&reference.oauth.oauthexception;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,32 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<section xml:id="oauth.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
&pecl.info;
<link xlink:href="&url.pear.package;oauth">&url.pear.package;oauth</link>
</para>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,80 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<appendix xml:id="oauth.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&extension.constants;
<para>
<variablelist>
<varlistentry>
<term>
<constant>OAUTH_SIG_METHOD_HMACSHA1</constant>
(<type>string</type>)
</term>
<listitem>
<para>
OAuth HMAC-SHA1 signature method
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>OAUTH_AUTH_TYPE_AUTHORIZATION</constant>
(<type>string</type>)
</term>
<listitem>
<para>
This constant represents putting OAuth parameters in the
<literal>Authorization</literal> header.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>OAUTH_AUTH_TYPE_URI</constant>
(<type>string</type>)
</term>
<listitem>
<para>
This constant represents putting OAuth parameters in the request
URI.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>OAUTH_AUTH_TYPE_FORM</constant>
(<type>string</type>)
</term>
<listitem>
<para>
This constant represents putting OAuth parameters as part of the
HTTP POST body.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

68
reference/oauth/oauth.xml Normal file
View file

@ -0,0 +1,68 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<phpdoc:classref xml:id="class.oauth" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The OAuth class</title>
<titleabbrev>OAuth</titleabbrev>
<partintro>
<!-- {{{ OAuth intro -->
<section xml:id="oauth.intro">
&reftitle.intro;
<para>
The OAuth extension provides a simple interface to interact with
data providers using the OAuth HTTP specification to protect
private resources.
</para>
</section>
<!-- }}} -->
<section xml:id="oauth.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>OAuth</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>OAuth</classname>
</ooclass>
</classsynopsisinfo>
<!-- }}} -->
<classsynopsisinfo role="comment">Methods</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.oauth')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
</classsynopsis>
<!-- }}} -->
</section>
</partintro>
&reference.oauth.entities.oauth;
</phpdoc:classref>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,88 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::__construct</refname>
<refpurpose>Create a new OAuth object</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<methodname>OAuth::__construct</methodname>
<methodparam><type>string</type><parameter>consumer_key</parameter></methodparam>
<methodparam><type>string</type><parameter>consumer_secret</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>signature_method</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>auth_type</parameter></methodparam>
</methodsynopsis>
<para>
Creates a new OAuth object
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>consumer_key</parameter></term>
<listitem>
<para>
The consumer key provided by the service provider.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>consumer_secret</parameter></term>
<listitem>
<para>
The consumer secret provided by the service provider.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>signature_method</parameter></term>
<listitem>
<para>
This optional parameter defines which signature method to use, by default it is <constant>OAUTH_SIG_METHOD_HMACSHA1</constant> (HMAC-SHA1).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_type</parameter></term>
<listitem>
<para>
This optional parameter defines how to pass the OAuth parameters
to a consumer, by default it is
<constant>OAUTH_AUTH_TYPE_AUTHORIZATION</constant> (in the
<literal>Authorization</literal> header).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,113 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.fetch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::fetch</refname>
<refpurpose>Fetch an OAuth protected resource.</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>void</type><methodname>OAuth::fetch</methodname>
<methodparam><type>string</type><parameter>protected_resource_url</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter role="reference">extra_parameters</parameter></methodparam>
</methodsynopsis>
<para>
Fetch a resource protected by OAuth.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>protected_resource_url</parameter></term>
<listitem>
<para>
URL to the OAuth protected resource.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>extra_parameters</parameter></term>
<listitem>
<para>
Extra parameters to send with the request for the resource.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>OAuth::fetch</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
try {
$oauth = new OAuth("consumer_key","consumer_secret",OAUTH_SIG_METHOD_HMACSHA1,OAUTH_AUTH_TYPE_AUTHORIZATION);
$oauth->setToken("access_token","access_token_secret");
$oauth->fetch("http://photos.example.net/photo?file=vacation.jpg");
$response_info = $oauth->getLastResponseInfo();
header("Content-Type: {$response_info["content_type"]}");
echo $oauth->getLastResponse();
} catch(OAuthException $E) {
echo "Exception caught!\n";
echo "Response: ". $E->lastResponse . "\n";
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>OAuth::getLastResponse</methodname></member>
<member><methodname>OAuth::getLastResponseInfo</methodname></member>
<member><methodname>OAuth::setToken</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,126 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.getaccesstoken" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::getAccessToken</refname>
<refpurpose>The getAccessToken purpose</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>array</type><methodname>OAuth::getAccessToken</methodname>
<methodparam><type>string</type><parameter>access_token_url</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>auth_session_handle</parameter></methodparam>
</methodsynopsis>
<para>
Fetch an access token, secret and any additional response parameters from the service provider.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>access_token_url</parameter></term>
<listitem>
<para>
URL to the access token API.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auth_session_handle</parameter></term>
<listitem>
<para>
Authorization session handle, this parameter does not have any
citation in the core OAuth 1.0 specification but may be
implemented by large providers.
<link xlink:href="&url.oauth.scale;">See ScalableOAuth</link>
for more information.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns an array containing the parsed OAuth response on success or NULL on failure.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>OAuth::getAccessToken</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
try {
$oauth = new OAuth(OAUTH_CONSUMER_KEY,OAUTH_CONSUMER_SECRET);
$oauth->setToken($request_token,$request_token_secret);
$access_token_info = $oauth->getRequestToken("https://example.com/oauth/access_token");
if(!empty($access_token_info)) {
print_r($access_token_info);
} else {
print "Failed fetching access token, response was: " . $oauth->getLastResponse();
}
} catch(OAuthException $E) {
echo "Response: ". $E->lastResponse . "\n";
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Array
(
[oauth_token] => some_token
[oauth_token_secret] => some_token_secret
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>OAuth::getLastResponse</methodname></member>
<member><methodname>OAuth::getLastResponseInfo</methodname></member>
<member><methodname>OAuth::setToken</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,64 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.getlastresponse" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::getLastResponse</refname>
<refpurpose>Get the last response</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>string</type><methodname>OAuth::getLastResponse</methodname>
<void />
</methodsynopsis>
<para>
Get the raw response of the most recent request.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns a string containing the last response.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>OAuth::getLastResponseInfo</methodname></member>
<member><methodname>OAuth::fetch</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,66 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.getlastresponseinfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::getLastResponseInfo</refname>
<refpurpose>Get HTTP information about the last response</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>array</type><methodname>OAuth::getLastResponseInfo</methodname>
<void />
</methodsynopsis>
<para>
Get HTTP information about the last response.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns an array containing the response information for the last
request. Constants from <function>curl_getinfo</function> may be
used.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>OAuth::fetch</methodname></member>
<member><methodname>OAuth::getLastResponse</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,111 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.getrequesttoken" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::getRequestToken</refname>
<refpurpose>Fetch a request token</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>array</type><methodname>OAuth::getRequestToken</methodname>
<methodparam><type>string</type><parameter>request_token_url</parameter></methodparam>
</methodsynopsis>
<para>
Fetch a request token, secret and any additional response parameters from the service provider.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>request_token_url</parameter></term>
<listitem>
<para>
URL to the request token API.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns an array containing the parsed OAuth response on success or NULL on failure.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>OAuth::getRequestToken</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
try {
$oauth = new OAuth(OAUTH_CONSUMER_KEY,OAUTH_CONSUMER_SECRET);
$request_token_info = $oauth->getRequestToken("https://example.com/oauth/request_token");
if(!empty($request_token_info)) {
print_r($request_token_info);
} else {
print "Failed fetching request token, response was: " . $oauth->getLastResponse();
}
} catch(OAuthException $E) {
echo "Response: ". $E->lastResponse . "\n";
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Array
(
[oauth_token] => some_token
[oauth_token_secret] => some_token_secret
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>OAuth::getLastResponse</methodname></member>
<member><methodname>OAuth::getLastResponseInfo</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,91 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.setauthtype" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::setAuthType</refname>
<refpurpose>The setAuthType purpose</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>OAuth::setAuthType</methodname>
<methodparam><type>string</type><parameter>auth_type</parameter></methodparam>
</methodsynopsis>
<para>
Set where the OAuth parameters should be passed.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>auth_type</parameter></term>
<listitem>
<para>
<parameter>auth_type</parameter> can be one of the following flags (in order of decreasing preference as per OAuth 1.0 section 5.2):
<variablelist>
<varlistentry>
<term><constant>OAUTH_AUTH_TYPE_AUTHORIZATION</constant></term>
<listitem>
<simpara>
Pass the OAuth parameters in the HTTP <literal>Authorization</literal> header.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>OAUTH_AUTH_TYPE_FORM</constant></term>
<listitem>
<simpara>
Append the OAuth parameters to the HTTP POST request body.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>OAUTH_AUTH_TYPE_URI</constant></term>
<listitem>
<simpara>
Append the OAuth parameters to the request URI.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,76 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.setnonce" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::setNonce</refname>
<refpurpose>Set the nonce for subsequent requests</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>OAuth::setNonce</methodname>
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
</methodsynopsis>
<para>
Sets the nonce for all subsequent requests.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>nonce</parameter></term>
<listitem>
<para>
The value for oauth_nonce.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>OAuth::setToken</methodname></member>
<member><methodname>OAuth::setAuthType</methodname></member>
<member><methodname>OAuth::setVersion</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,91 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.settoken" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::setToken</refname>
<refpurpose>Sets the token and secret</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>OAuth::setToken</methodname>
<methodparam><type>string</type><parameter>token</parameter></methodparam>
<methodparam><type>string</type><parameter>token_secret</parameter></methodparam>
</methodsynopsis>
<para>
Set the token and secret for subsequent requests.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>token</parameter></term>
<listitem>
<para>
The OAuth token.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>token_secret</parameter></term>
<listitem>
<para>
The OAuth token secret.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>OAuth::setToken</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
$oauth = new OAuth(OAUTH_CONSUMER_KEY,OAUTH_CONSUMER_SECRET);
$oauth->setToken("token","token-secret");
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,65 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="oauth.setversion" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>OAuth::setVersion</refname>
<refpurpose>Set the OAuth version</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>OAuth::setVersion</methodname>
<methodparam><type>string</type><parameter>version</parameter></methodparam>
</methodsynopsis>
<para>
Sets the OAuth version for subsequent requests
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>version</parameter></term>
<listitem>
<para>
OAuth version, default value is always "1.0"
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,116 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<phpdoc:classref xml:id="class.oauthexception" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>OAuthException class</title>
<titleabbrev>OAuthException</titleabbrev>
<partintro>
<!-- {{{ OAuthException intro -->
<section xml:id="oauthexception.intro">
&reftitle.intro;
<para>
This exception is thrown when exceptional errors when using the OAuth extension and contains useful debugging information.
</para>
</section>
<!-- }}} -->
<section xml:id="oauthexception.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>OAuthException</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>OAuthException</classname>
</ooclass>
<ooclass>
<modifier>extends</modifier>
<classname>Exception</classname>
</ooclass>
</classsynopsisinfo>
<!-- }}} -->
<classsynopsisinfo role="comment">Properties</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<varname linkend="oauthexception.props.lastResponse">lastResponse</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">Inherited methods</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
</classsynopsis>
<!-- }}} -->
</section>
<!-- {{{ OAuthException properties -->
<section xml:id="oauthexception.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="oauthexception.props.message">
<term><varname>message</varname></term>
<listitem>
<para>A human readable message about what went wrong</para>
</listitem>
</varlistentry>
<varlistentry xml:id="oauthexception.props.code">
<term><varname>code</varname></term>
<listitem>
<para>Exception code</para>
</listitem>
</varlistentry>
<varlistentry xml:id="oauthexception.props.file">
<term><varname>file</varname></term>
<listitem>
<para>File where exception was thrown</para>
</listitem>
</varlistentry>
<varlistentry xml:id="oauthexception.props.line">
<term><varname>line</varname></term>
<listitem>
<para>File where exception was thrown</para>
</listitem>
</varlistentry>
<varlistentry xml:id="oauthexception.props.lastResponse">
<term><varname>lastResponse</varname></term>
<listitem>
<para>The response of the exception which occured, if any</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- }}} -->
</partintro>
</phpdoc:classref>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,31 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<reference xml:id="ref.oauth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>OAuth &Functions;</title>
&reference.oauth.entities.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

52
reference/oauth/setup.xml Normal file
View file

@ -0,0 +1,52 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<chapter xml:id="oauth.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<section xml:id="oauth.requirements">
&reftitle.required;
<para>
PECL/oauth requires PHP 5.1 or newer, ext/hash and libcurl with HTTPS support.
</para>
</section>
<!-- {{{ Installation -->
&reference.oauth.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="oauth.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<section xml:id="oauth.resources">
&reftitle.resources;
&no.resource;
</section>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,51 @@
<?xml version='1.0' encoding='utf-8'?>
<!-- $Revision: 1.1 $ -->
<!--
Do NOT translate this file
-->
<versions>
<!-- Functions -->
<function name='oauth_urlencode' from='PECL OAuth &gt;=0.99.2'/>
<!-- Methods -->
<function name='oauth::__construct' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::getrequesttoken' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::getaccesstoken' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::getlastresponse' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::getlastresponseinfo' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::settoken' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::setversion' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::setauthtype' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::setnonce' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauth::fetch' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::__clone' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::__construct' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::getmessage' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::getcode' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::getfile' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::getline' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::gettrace' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::getprevious' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::gettraceasstring' from='PECL OAuth &gt;= 0.99.1'/>
<function name='oauthexception::__tostring' from='PECL OAuth &gt;= 0.99.1'/>
</versions>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->