Merge branch 'master' into 5.6

README.md

@@ -25,6 +25,7 @@ Grab Wikipedia (or another MediaWiki) page in Laravel.
 - [Languages](#languages)
 - [Methods](#methods)
 - [Preview](#preview)
+- [Random](#random)
 - [Advanced](#advanced)
   - [Configuration](#configuration)
   - [Get by id](#get-by-id)
@@ -126,6 +127,20 @@ The preview consists of an intro section and the main image. It has the same API
 echo (new Wikipedia)->preview('Donald Trump');
 ```
 
+## Random
+
+You can grab random page:
+
+```php
+echo (new Wikipedia)->random();
+```
+
+Or random preview:
+
+```php
+echo (new Wikipedia)->randomPreview();
+```
+
 ## Advanced
 
 ### Configuration
@@ -150,6 +165,12 @@ Just pass an integer to the method:
 echo (new Wikipedia)->page(4848272);
 ```
 
+The same is true for preview:
+
+```php
+echo (new Wikipedia)->preview(4848272);
+```
+
 ### MediaWiki
 
 You are not limited to Wikipedia. Grab the pages from any MediaWiki site:

src/Grabber.php

@@ -5,6 +5,7 @@
 use GuzzleHttp\Client;
 use Illuminated\Wikipedia\Grabber\Page;
 use Illuminated\Wikipedia\Grabber\Preview;
+use Illuminated\Wikipedia\Grabber\Random;
 
 abstract class Grabber
 {
@@ -35,6 +36,21 @@ public function preview($title)
         return new Preview($this->client, $title);
     }
 
+    public function random()
+    {
+        return $this->page($this->randomTitle());
+    }
+
+    public function randomPreview()
+    {
+        return $this->preview($this->randomTitle());
+    }
+
+    protected function randomTitle()
+    {
+        return (new Random($this->client))->title();
+    }
+
     abstract protected function baseUri();
 
     protected function userAgent()

src/Grabber/Random.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Illuminated\Wikipedia\Grabber;
+
+use GuzzleHttp\Client;
+
+class Random
+{
+    protected $client;
+
+    public function __construct(Client $client)
+    {
+        $this->client = $client;
+    }
+
+    public function title()
+    {
+        $response = head($this->request($this->params())['query']['random']);
+
+        return $response['title'];
+    }
+
+    /**
+     * @see https://www.mediawiki.org/wiki/API:Query#Getting_a_list_of_page_IDs - FormatVersion
+     * @see https://en.wikipedia.org/w/api.php?action=help&modules=query+random - Random
+     */
+    protected function params()
+    {
+        return [
+            'query' => [
+                'action' => 'query',
+                'format' => 'json',
+                'formatversion' => 2,
+                'list' => 'random',
+                'rnnamespace' => 0,
+                'rnfilterredir' => 'nonredirects',
+                'rnlimit' => 1,
+            ],
+        ];
+    }
+
+    protected function request(array $params)
+    {
+        return json_decode(
+            $this->client->get('', $params)->getBody(),
+            true
+        );
+    }
+}