it-shura / mediawiki-sdk
SDK for MediaWiki API
Installs: 1 147
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 5
Forks: 0
Open Issues: 0
Requires
- php: >=5.6
- symfony/console: ~3.3
Requires (Dev)
- mikey179/vfsstream: ^1.6
- mockery/mockery: dev-master
- phpunit/phpunit: ^4.8
README
MediaWiki SDK - библиотека для работы с API MediaWiki.
Минимальная версия MediaWiki: 1.27+.
Содержание
Установка
Для установки MediaWiki SDK выполните команду:
composer require it-shura/mediawiki-sdk
Быстрый старт
use MediaWiki\Api\Api; use MediaWiki\Api\Exceptions\ApiException; use MediaWiki\Storage\FileStore; use MediaWiki\HttpClient\CurlHttpClient; $url = 'http://ru.example.com/api.php'; $httpClient = new CurlHttpClient(); $storage = new FileStore(__DIR__.'/storage/cache'); $api = new Api($url, $httpClient, $storage);
Авторизация
$username = 'John@FooBot'; $password = 'pri9l1fl1j315hmp3okbnqspqcgaue1t'; try { $api->login($username, $password); } catch (ApiException $exception) { echo sprintf('MediaWiki API Error: ', $exception->getMessage()); exit; } // bool(true) var_dump($api->isLoggedIn()); // выход $api->logout();
Выполнение запроса
$parameters = [ 'action' => 'query', 'list' => 'allpages', ]; $response = $api->request('POST', $parameters); // или $parameters = [ 'list' => 'allpages', ]; $response = $api->query($parameters); var_dump($response);
Параметры метода request
- method - HTTP-метод (POST/GET)
- parameters - параметры запроса (опционально)
- headers - заголовки запроса (опционально)
- decode - декодирует запрос, если передан параметр
true
(только json, опционально)
Параметры метода query
- parameters - параметры запроса
- decode - декодирует запрос, если передан параметр
true
(только json, опционально)