zelenin/elo

A PHP implementation of Elo rating system

Elo

A PHP implementation of Elo rating system, _(*1)

Installation

Composer

The preferred way to install this extension is through Composer., _(*2)

Either run, _(*3)

php composer.phar require zelenin/elo "dev-master"

or add, _(*4)

"zelenin/elo": "dev-master"

to the require section of your composer.json, _(*5)

Usage

Create two players with current ratings:, _(*6)

use Zelenin\Elo\Player;

$player1 = new Player(1200);
$player2 = new Player(800);

Create match:, _(*7)

use Zelenin\Elo\Match;

$match = new Match($player1, $player2);
$match->setScore(1, 0)
    ->setK(32)
    ->count();

Get players:, _(*8)

$player1 = $match->getPlayer1();
$player2 = $match->getPlayer2();

Get new ratings:, _(*9)

$newRating1 = $player1->getRating();
$newRating2 = $player2->getRating();

Advanced usage

If you want use this library for not-traditional for Elo sports like football, ice hockey, basketball, you may set additional handlers for setting goal index and home correction., _(*10)

use Zelenin\Elo\Match;
use Zelenin\Elo\Player;

$player1 = new Player(1200);
$player2 = new Player(800);

$goalIndexHandler = function ($score1, $score2) {
    $diff = abs($score1 - $score2);
    if ($diff > 0) {
        return sqrt($diff);
    }
    return 1;
};

$homeCorrectionHandler = function ($home, $diff) {
    $coefficient = 100;
    if ($home == 1) {
        return $diff - $coefficient;
    }
    if ($home == 2) {
        return $diff + $coefficient;
    }
    return $diff;
};

$match = new Match($player1, $player2);
$match->setScore(1, 0)
    ->setK(32)
    ->setGoalIndexHandler($goalIndexHandler)
    ->setHome(2)
    ->setHomeCorrectionHandler($homeCorrectionHandler)
    ->count();

$newRating1 = $player1->getRating();
$newRating2 = $player2->getRating();

Info

See Wiki about Elo rating system, _(*11)

Author

Aleksandr Zelenin, e-mail: aleksandr@zelenin.me, _(*12)