mcmainiac/phpubg

This package is abandoned and no longer maintained. The author suggests using the jmwri/pubg-php package instead.

PHP Wrapper for PUBG tracker api

Maintainers

Details

github.com/ricardoboss/PHPUBG

Homepage

Source

Issues

Installs: 132

Dependents: 0

Suggesters: 0

Security: 0

Stars: 6

Watchers: 2

Forks: 2

Open Issues: 0

v1.0.3 2017-11-02 22:58 UTC

Requires

  • php: >=7.1.5

Requires (Dev)

MIT d7c95b2414a2caba8e87e5a2dce7e477adb24e6e

This package is auto-updated.

Last update: 2020-02-02 01:27:34 UTC

README

Test Status

PHP wrapper for the PUBG Tracker API.

Installation

PHPUBG is available on packagist, so you can easily require it via composer:

composer require mcmainiac/phpubg

To use this as a standalone library (without composer), download the repository and extract it somewhere (preferably in your projects libraries folder) and set up an autoloader to load all files dynamically. The root namespace of this library is \PHPUBG.

Usage

To get your own api key, please visit pubgtracker.com/site-api.

Assuming you are at the root of your project (the vendor folder is within your current folder):

<?php

require __DIR__  . "/vendor/autoload.php";

use PHPUBG\Region;
use PHPUBG\PubgBuilder;

$statsEurope = PubgBuilder::setApiKey("your-api-key")
    ->getPlayer("MCMainiac")
    ->getStats(
        Region::get(Region::EUROPE)
    );

var_dump($statsEurope);

This should dump all stats available for the player "MCMainiac" in the region "Europe".

You can also use the Steam Id (a 64 bit number) instead of the username. PHPUBG will automatically resolve the username and get the stats:

<?php
$builder = PubgBuilder::setApiKey("your-api-key");

$playerByName = $builder->getPlayer("MCMainiac");
$playerBySteamId = $builder->getPlayer(76561198128415640); // steam id for "MCMainiac"

// At this point $playerByName and $playerBySteamId are equivalent entities.

$playerByName->getNickname() == $playerBySteamID->getNickname(); // will return true

If you want to apply another filter, just pass it to the getStats method:

$player->getStats($region, $season, $mode);

whereas:

  • $region is an instance from the \PHPUBG\Region class or null
  • $season is an instance from the \PHPUBG\Season class or null
  • $mode is an instance from the \PHPUBG\matches\MatchMode class or null

If any variable of the above is null, then any value for this filter is accepted.

Example: You want to get all stats for the region "Europe" and the match mode "Solo":

$region = Region::get(Region::EUROPE);
$mode = MatchMode::get(MatchMode::SOLO);

$europeSoloStats = $player->getStats($region, null, $mode);

Development

Feel free to clone the repository, make your changes and open a pull request.

Please report issues right here on GitHub using the issues system.

Notes

When requesting stats, please keep the number of requests at ~1/sec.

Thanks to pubgtracker.com for their public api.

Thanks to all contributors!

Support on Beerpay

Hey dude! Help me out for a couple of 🍻!

Beerpay Beerpay