Download the PHP package mrnamra/bracket-manager without Composer
On this page you can find all versions of the php package mrnamra/bracket-manager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package bracket-manager
Bracket Manager PHP Library
A high-performance, developer-friendly PHP library for generating and managing tournament bracket data.
This library is inspired by brackets-manager.js and its output is fully JSON compatible with brackets-viewer.js, providing a robust PHP backend for tournament visualizations.
🚀 Key Features
- 🏆 Single & Double Elimination: Native support for standard tournament structures.
- ⚡ Automatic Advancement: Intelligent winner/loser propagation, including seamless BYE handling.
- 🧬 Advanced Seeding: 7 built-in seeding algorithms (Inner-Outer, Natural, Reverse, etc.).
- 🧩 Flexible Data Model: Works with custom participant IDs and supports arbitrary metadata.
- 📦 Composer Ready: Easy integration into any modern PHP project.
🛠 Installation
Install the package via Composer:
📖 Quick Start
1. Initialize the Manager
The BracketManager uses a bootstrapper to set up its internal repositories and services.
2. Creating a Single Elimination Bracket
Perfect for quick knockout tournaments where one loss means elimination.
Visual Structure:
3. Creating a Double Elimination Bracket
Includes a Winners Bracket and a Losers Bracket, giving participants a second chance.
Visual Structure:
📝 Configuration Schema
When calling $manager->create($stage), the following structure is used:
Stage Configuration ($stage)
| Key | Type | Required | Description |
|---|---|---|---|
tournament_id |
int |
Yes | ID of the parent tournament. |
type |
string |
Yes | single_elimination or double_elimination. |
seeding |
array |
Yes | Key-Value pairs: ['ID' => 'Name']. |
settings |
array |
Yes | See Settings table below. |
id |
int |
No | Internal stage ID (defaults to 0). |
name |
string |
No | Display name (defaults to "Stage"). |
metadata |
array |
No | Custom data preserved in the result. |
Settings Configuration (settings)
| Key | Type | Required | Description |
|---|---|---|---|
size |
int |
Yes | Total slots (must be power of 2, e.g., 4, 8, 16). |
seedOrdering |
array |
Yes | Array containing one of the Seeding types. |
grandFinal |
string |
Yes | simple, none, or double (DE only). |
matchesChildCount |
int |
Yes | Sub-match count (usually 0 for standard). |
🧬 Seeding Algorithms
Specify the algorithm in settings['seedOrdering'] (e.g., ['inner_outer']):
natural: Standard 1-2, 3-4 progression.inner_outer: Traditional bracket seeding (1-8, 4-5, 2-7, 3-6).reverse: 8-7, 6-5 progression.half_shift: Rotational seeding for variety.reverse_half_shift: Inverted rotational seeding.pair_flip: Flips adjacent pairs.half_shift_inner_outer: Hybrid approach.
🔄 Updating Scores & Advancement
The library handles the complexity of advancing winners and dropping losers.
Match Status Codes
The result uses standardized status codes compatible with the brackets-viewer.js UI:
0: Locked - Dependencies (previous rounds) are not yet finished.1: Waiting - One participant is ready, waiting for the other.2: Ready - Both participants are ready to play.3: Running - The match is currently in progress.4: Completed - Match is finished; winner has advanced.
🏆 Credits & License
Developed with ❤️ by MrNamra.
This project is licensed under the MIT License. See the LICENSE file for details.
