PHPackages                             team-reflex/challonge-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. team-reflex/challonge-php

ActiveLibrary[API Development](/categories/api)

team-reflex/challonge-php
=========================

PSR-18 compatible library to interface with the bracket generator Challonge.

5.0(3y ago)2327.7k↓93.9%10[2 issues](https://github.com/teamreflex/ChallongePHP/issues)[1 PRs](https://github.com/teamreflex/ChallongePHP/pulls)MITPHPPHP ^8.1 | ^8.2CI failing

Since Dec 16Pushed 6mo ago7 watchersCompare

[ Source](https://github.com/teamreflex/ChallongePHP)[ Packagist](https://packagist.org/packages/team-reflex/challonge-php)[ RSS](/packages/team-reflex-challonge-php/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (9)Versions (24)Used By (0)

ChallongePHP
============

[](#challongephp)

[![Test](https://github.com/teamreflex/ChallongePHP/workflows/Test/badge.svg?branch=master)](https://github.com/teamreflex/ChallongePHP/workflows/Test/badge.svg?branch=master)[![Latest Version](https://camo.githubusercontent.com/f0d255e6fbc926b6726b86b9983bbfb1de56a2d4590a14b73ae7d43d1734fe60/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7465616d2d7265666c65782f6368616c6c6f6e67652d7068702e737667)](https://packagist.org/packages/team-reflex/challonge-php)[![Downloads](https://camo.githubusercontent.com/e462e8559ab91a445b81b677da1a6fad261cdf2c96826fc43839a4572cd2fba8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7465616d2d7265666c65782f6368616c6c6f6e67652d7068702e737667)](https://packagist.org/packages/team-reflex/challonge-php)

PSR-18 compliant package for interfacing with the [Challonge](http://api.challonge.com/v1) API.

Installation
------------

[](#installation)

Refer to the table for PHP version compatibility:

ChallongePHP Ver.Compatible PHP^5.08.1 - 8.2^4.08.0 - 8.1^3.07.4 - 8.0^2.17.4^2.07.4^1.07.0 - 7.4Install via composer:

```
composer require team-reflex/challonge-php:version
```

Usage
-----

[](#usage)

As the package is PSR-18 compliant, it does not come with an HTTP client by default.

You can use a client such as Guzzle, and pass an instance of it when instantiating:

```
$http = new GuzzleHttp\Client();
$challonge = new Challonge($http, 'api_key_here', true);
```

By default, the package maps the keys of any input, as Challonge requires its input to be in a format such as:

```
$tournament = $challonge->createTournament([
    'tournament[name]' => 'test'
]);
```

Which means you are able to use the package without prefixing your keys:

```
$tournament = $challonge->createTournament([
    'name' => 'test'
]);
```

You can change the third argument to `false` to disable this mapping if you would prefer to do it yourself.

Now you're ready to make requests:

```
$tournament = $challonge->fetchTournament('challongephptest');
```

API Updates
-----------

[](#api-updates)

Challonge does not lock their API and has been consistently adding new fields to objects, thus breaking strongly typed DTOs.

As of 3.0.4, all three DTOs have been marked to ignore missing fields. If Challonge adds a new field, it will no longer throw a `DataTransferObjectError`, but the DTO will also however not contain that new field.

Documentation
-------------

[](#documentation)

As the package is fully type-hinted, everything should be self documenting, however there is documentation in the wiki.

Contact
-------

[](#contact)

- [@Reflexgg](http://twitter.com/Reflexgg)
- [@rfxkairu](http://twitter.com/rfxkairu)

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance44

Moderate activity, may be stable

Popularity34

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity85

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 62.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~153 days

Recently: every ~178 days

Total

22

Last Release

682d ago

Major Versions

v1.0.3 → 2.0.0-beta2020-10-24

2.1 → 3.02021-01-03

3.1.1 → 4.02022-08-03

3.2 → 5.02023-06-13

5.0 → 6.0.x-dev2024-10-04

PHP version history (6 changes)2.0.0-betaPHP ^7.4

3.0PHP ^7.4 | ^8.0

4.0PHP ^8.0 | ^8.1

3.x-devPHP ^7.4 | ^8.0 | ^8.1

5.0PHP ^8.1 | ^8.2

6.0.x-devPHP ~8.1.0 || ~8.2.0 || ~8.3.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/a7f351daf21fdfaf906b234bf4282b2089fe36d75fd19504e8e262af78fa43fe?d=identicon)[uniquoooo](/maintainers/uniquoooo)

![](https://www.gravatar.com/avatar/8c4b542cd7b5f3a4f3587cbb2ffe26e815b3c9aa9892c04fc5d93ec8d0db5d5e?d=identicon)[Kairu](/maintainers/Kairu)

---

Top Contributors

[![kylekz](https://avatars.githubusercontent.com/u/450516?v=4)](https://github.com/kylekz "kylekz (41 commits)")[![Apfelwurm](https://avatars.githubusercontent.com/u/23552885?v=4)](https://github.com/Apfelwurm "Apfelwurm (13 commits)")[![xKairu](https://avatars.githubusercontent.com/u/169433509?v=4)](https://github.com/xKairu "xKairu (10 commits)")[![clamburger](https://avatars.githubusercontent.com/u/1396298?v=4)](https://github.com/clamburger "clamburger (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

bracketchallongephpteam-reflex

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/team-reflex-challonge-php/health.svg)

```
[![Health](https://phpackages.com/badges/team-reflex-challonge-php/health.svg)](https://phpackages.com/packages/team-reflex-challonge-php)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M777](/packages/sylius-sylius)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

86337.5k](/packages/flow-php-flow)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

265.2k](/packages/aedart-athenaeum)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6943.5M449](/packages/drupal-core-recommended)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

762297.9k53](/packages/civicrm-civicrm-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
