Search clans in server.

Author: hichxm

src/wargaming.php

@@ -4,6 +4,7 @@
 
 use Exception;
 use GuzzleHttp\Client;
+use function GuzzleHttp\Psr7\str;
 
 
 /**
@@ -19,6 +20,8 @@ class WargamingApi
         "accountSearch" => "api.worldoftanks.{region}/wgn/account/list/?application_id={key}&search={search}&limit={limit}&type={method}",
         "accountId" => "api.worldoftanks.{region}/wgn/account/info/?application_id={key}&account_id={accounts}",
 
+        "clansSearch" => "api.worldoftanks.{region}/wgn/clans/list/?application_id={key}&search={search}&limit={limit}&page_no={pagination}",
+
         "serverInfo" => "api.worldoftanks.{region}/wgn/servers/info/?application_id={key}"
     ];
 
@@ -46,7 +49,7 @@ public function searchPlayers($search, $options = null)
 
             //Search not specified
             throw new Exception("SEARCH_NOT_SPECIFIED", "402");
-        } else if (strlen($search) <= 3) {
+        } else if (strlen($search) < 3) {
 
             //Search no enough
             throw new Exception("NOT_ENOUGH_SEARCH_LENGTH", "407");
@@ -113,6 +116,42 @@ public function serverInfo($region = null)
 
     }
 
+    /**
+     * @param string $search
+     * @param array|null $option
+     * @return array
+     * @throws Exception
+     */
+    public function searchClans($search, $option = null)
+    {
+
+        if (strlen($search) == 0) {
+
+            //Search not specified
+            throw new Exception("SEARCH_NOT_SPECIFIED", "402");
+        } else if (strlen($search) < 3) {
+
+            //Search no enough
+            throw new Exception("NOT_ENOUGH_SEARCH_LENGTH", "407");
+        } else if (strlen($search) >= 100) {
+
+            //Search as exceeded
+            throw new Exception("SEARCH_LIST_LIMIT_EXCEEDED", "407");
+        }
+
+        $returned = $this->request("clansSearch", [
+            "search" => $search,
+            "limit" => !empty($options['limit']) ? $options['limit'] : 100,
+            "pagination" => !empty($options['pagination']) ? $options['pagination'] : 1
+        ]);
+
+        return [
+            "count" => $returned['meta']['count'],
+            "total" => $returned['meta']['total'],
+            "clans" => $returned['data']
+        ];
+    }
+
     /**
      * @param string $ref
      * @param array $options
@@ -138,6 +177,14 @@ private function request($ref, $options)
                 $link = str_replace("{accounts}", $options['accounts'], $link);
                 break;
 
+            case "clansSearch":
+
+                //Replace data of the link
+                $link = str_replace("{search}", $options['search'], $link);
+                $link = str_replace("{limit}", $options['limit'], $link);
+                $link = str_replace("{pagination}", $options['pagination'], $link);
+                break;
+
             case "serverInfo":
 
                 //Replace data of the link

tests/testWargamingApi.php

@@ -90,4 +90,18 @@ public function check_server_info_with_custom_region() {
 
     }
 
+    /**
+     * @test
+     * @throws Exception
+     */
+    public function check_search_clans_with_default_option()
+    {
+        //Init Wargaming.net api key and region
+        $war = new WargamingApi("e9807cace93606169c54fb8e9ec763b2", "eu");
+
+        $clans = $war->searchClans("aze");
+
+        $this->assertEquals(100, $clans['count']);
+    }
+
 }