commit	442686fd2586d7733a4e3b9729bbbbec850e9b40	[log] [tgz]
author	libraryupgrader <tools.libraryupgrader@tools.wmflabs.org>	Sat Nov 30 04:08:50 2024 +0000
committer	libraryupgrader <tools.libraryupgrader@tools.wmflabs.org>	Sat Nov 30 04:08:53 2024 +0000
tree	cd0fde3788b700bcfeadd0c56c501089a7ddb8b0
parent	93cf9e642fb14d494b73bd316d2fea05d5aeaa3c [diff]

tree: cd0fde3788b700bcfeadd0c56c501089a7ddb8b0

README.md

mediawiki/oauthclient

PHP OAuth client for use with Wikipedia and other MediaWiki-based wikis running the OAuth extension.

Installation

$ composer require mediawiki/oauthclient

Usage

For working example code, see the demo directory.

General usage is as follows:

Create a new Client with consumer key that you've registered with the wiki. Setting an user agent is highly encouraged.

$conf = new ClientConfig( 'https://example.org/w/index.php?title=Special:OAuth' );
$conf->setConsumer( new Consumer(
    'e331e186b64a938591e7614170814a75',
    '9b61abdfa2b88f05670af3919302b12bbc6a6e10'
) );
$conf->setUserAgent( 'MyCoolApp MediaWikiOAuthClient/1.0' );
$client = new Client( $conf );

Retrieve the authentication URL and the Request Token:

list( $authUrl, $requestToken ) = $client->initiate();

Store the Request Token somewhere and send the user to the authentication URL.
When the user comes back from the wiki they'll arrive at your callback URL, and the query string will contain an oauth_verifier key. Use this to retrieve an Acccess Token:
```
$accessToken = $client->complete( $requestToken,  $_GET['oauth_verifier'] );
```

Once you've got an Access Token you can store it and use it to make authenticated requests to the wiki.

To get the user's identity:

$ident = $client->identify( $accessToken );

To make any API call:

$userInfo = $client->makeOAuthCall(
     $accessToken,
     "https://example.org/w/api.php?action=query&meta=userinfo&uiprop=rights&format=json"
);

Running tests

composer install --prefer-dist
composer test

History

The code is a refactored version of Stype/mwoauth-php, which in turn is partially based on Andy Smith's OAuth library. Some code is taken from wikimedia/slimapp. See CHANGELOG.md for more details.

mediawiki/oauthclient

Installation

Usage

Running tests

History

pFad - (p)hone/(F)rame/(a)nonymizer/(d)eclutterfier! Saves Data!