2017 © Pedro Peláez
 

library clash-royale-php

THE UNOFFICIAL PHP Clash Royale API

image

firegore2/clash-royale-php

THE UNOFFICIAL PHP Clash Royale API

  • Friday, June 22, 2018
  • by firegore2
  • Repository
  • 7 Watchers
  • 10 Stars
  • 76 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 3 Forks
  • 0 Open issues
  • 16 Versions
  • 33 % Grown

The README.md

clash-royale-php Packagist GitHub release Total Downloads phpdocumentor

THE UNOFFICIAL PHP Clash Royale Wrapper, (*1)

INFO

This work with the back-end of this page Clash Royale API, (*2)

REQUIREMENTS

PHP 5.5 or greater, (*3)

Composer, (*4)

INSTALLATION

In the root of your project (the same path which contains the composer file) enter, (*5)

 composer update

to install the library or use, (*6)

composer require firegore2/clash-royale-php

to install in your own project., (*7)

TOKEN

You need a developer token to use the API., (*8)

These are the steps to obtain it: 1. Go to the discord server of the API 2. Go to the #developer-key channel. 3. Type ?crapikey get 4. The bot will send you a DM (direct message) along with your key., (*9)

METHODS

API Document See examples folder for more information, (*10)

getPlayer()

<?php
use CR\Api;
require 'vendor/autoload.php';
   /**
   * Return all the information about the given users tag
   * @method getPlayer
   * @param  array     $player          Array with the id of the profiles
   * @param  array     $keys            Array with the exact parameters to request
   * @param  array     $exclude         Array with the exact parameters to exclude in the request
   * @return Player[]                   Array of Player Objects if given more than one profile, else return one Player Object
   */
$token = "YOUR_TOKEN";
$api = new Api($token);
try{
 $player = $api->getPlayer(["JSDFS45","ASDAD123"]);
 d($player); //This display the array with Player objects
}
catch(Exception $e){
 d($e);
}

getClan()

<?php
use CR\Api;
require 'vendor/autoload.php';
/**
 * Return all the information about the given clan tag
 * @method getClan
 * @param  array  $clan       Array with the tag of the clans
 * @return Clan[]         Array of Clan Objects if given more than one profile, else return one Clan Object
 */
$token = "YOUR_TOKEN";
$api = new Api($token);
try{
 $clans = $api->getClan(["clan_tag1","clan_tag2"]);
 d($clans); //This display the Array of Clan objects
}
catch(Exception $e){
 d($e);
}

getTop()

<?php
use CR\Api;
require 'vendor/autoload.php';

/**
 * Return all information about the top players or clans
 * @method getTop
 * @param  array  $top  Array with values "players" or/and "clans"
 * @return array        Array with key of respectives top type ("players" or "clans") and with their values an array with "lastUpdate" 
 * of the top list and the respective array with the respective objects type ("players" = array CR\Objects\Profile)
 */

$token = "YOUR_TOKEN";
$api = new Api($token);
try{
 $tops = $api->getTop(["players","clans"]);
 d($tops); //This display the array with Profile objects
}
catch(Exception $e){
 d($e);
}

clanSearch

<?php
ini_set('max_execution_time', 3000);
use CR\Api;
require 'vendor/autoload.php';

$token = "YOUR_TOKEN";
$api = new Api($token);

try {

  /**
   * Search clans by their attributes
   * @method clanSearch
   * @param  string           $name                 (Optional)Clan name text search.
   * @param  int              $score                (Optional) Minimum clan score.
   * @param  int              $minMembers           (Optional) Minimum number of members. 0-50
   * @param  int              $maxMembers           (Optional) Maximum number of members. 0-50
   * @return ClanSearch[]     $clanSearch           Returns an array of Clan objects that match the search parameters
   */

  $clansSearch = $api->clanSearch("INFRAMUNDO",35140,44,46);

  foreach ($clansSearch as $clanSearch) {

    /**
     * ClanSearch object
     *
     * @method    string              getTag()                Returns the tag of the clan
     * @method    string              getName()               Returns the name of the clan
     * @method    string              getType()               Returns the admission type of the clan
     * @method    int                 getScore()              Returns the score of the clan
     * @method    int                 getMemberCount()        Returns the members number of the clan
     * @method    int                 getRequiredScore()      Returns the required score to enter the clan
     * @method    int                 getDonations()          Returns the total donations per week of the clan
     * @method    AllianceBadge       getBadge()              Returns the AllianceBadge Object of the clan
     * @method    Location            getLocation()           Returns the Location Object of the clan
     */
    $tag = $clanSearch->getTag();
    $name = $clanSearch->getName();
    $type = $clanSearch->getType();
    $score = $clanSearch->getScore();
    $memberCount = $clanSearch->getMemberCount();
    $requiredScore = $clanSearch->getRequiredScore();
    $donations = $clanSearch->getDonations();

    /**
     * AlianceBadge object
     *
     *
     * @method    string              getName()               Returns the name of the badge
     * @method    string              getCategory()           Returns the category name of the badge
     * @method    int                 getId()                 Returns the id of the badge
     * @method    string              getImage()              Returns the image url of the badge
     *
     *
     */
    $badge = $clanSearch->getBadge();
    $name = $badge->getName();
    $category = $badge->getCategory();
    $id = $badge->getId();
    $image = $badge->getImage();


    /**
     *  Location object
     * @method    string              getName()               Returns the name of the location.
     * @method    bool                getIsCountry()          Returns true if the location is a country. otherwise returns false.
     * @method    string              getCode()               Returns the country/continent code
     *
     *
     * @method    string              getContinent()          Returns the continent name
     * @method    string              getContinentCod()       Returns the continent code
     * @method    string              getCountry()            Returns the country name
     * @method    string              getCountryCode()        Returns the country code
     */
    $location = $clanSearch->getLocation();
    $country = $location->getCountry();
    $continent = $location->getContinent();
    $countryCode = $location->getCountryCode();
    $continentCode = $location->getContinentCode();

    d(
      $clanSearch,
      $tag,
      $name,
      $type,
      $score,
      $memberCount,
      $requiredScore,
      $donations,
      $badge,
      $name,
      $category,
      $id,
      $image,
      $location,
      $country,
      $continent,
      $countryCode,
      $continentCode
    );
  }
} catch (\Exception $e) {
  d($e);
}

TEST, (*11)

The Versions

22/06 2018

dev-master

9999999-dev https://github.com/firegore2/clash-royale-php

THE UNOFFICIAL PHP Clash Royale API

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

clash royale clash royale php

16/06 2018
01/06 2018

1.3.2

1.3.2.0 https://github.com/firegore2/clash-royale-php

THE UNOFFICIAL PHP Clash Royale API

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

clash royale clash royale php

23/05 2018

1.3.1

1.3.1.0 https://github.com/firegore2/clash-royale-php

THE UNOFFICIAL PHP Clash Royale API

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

clash royale clash royale php

07/05 2018

1.3

1.3.0.0 https://github.com/firegore2/clash-royale-php

THE UNOFFICIAL PHP Clash Royale API

  Sources   Download

BSD-3-Clause

The Requires

 

The Development Requires

clash royale clash royale php

24/03 2018
05/03 2018