Gestione gratuita dei tornei · Regole FIDE 2026. Apri l’app →
Guida per sviluppatori e arbitri
Integra OpenPairing in PHP o dalla riga di comando
Esempi minimi per installare il motore, calcolare un turno, produrre classifiche e verificare un torneo TRF26. Il runtime è stateless, offline e non usa database.
01
Installa e controlla il runtime
Richiede PHP 8.3 o successivo. ext-gmp è consigliata per tornei medi e grandi.
composer install
composer check
php bin/openpairing.php --version
02
Calcola abbinamenti e classifiche dalla CLI
php bin/openpairing.php tournament.trf > pairing.json
php bin/openpairing.php --input-format=json tournament.json > pairing.json
php bin/openpairing.php --standings tournament.trf > standings.json
php bin/openpairing.php --standings --tie-breaks=DE/P,BH/C1/P,SB/C1 state.json
Usa l’output soltanto con exit code 0. Errori e input ambigui falliscono in modo esplicito.
03
Usa l’API PHP pubblica
Decodifica lo stato canonico e restituisce un risultato strutturato, mai un successo parziale.
<?php
require __DIR__ . '/vendor/autoload.php';
use OpenPairing\Engine\Dutch\DutchPairingEngine;
use OpenPairing\Format\Json\CanonicalJson;
$json = file_get_contents('tournament.json');
$state = (new CanonicalJson())->decode($json);
$result = (new DutchPairingEngine())->pair($state);
if ($result->violations !== []) {
throw new RuntimeException(json_encode($result->toArray()['violations']));
}
echo json_encode($result->toArray(), JSON_PRETTY_PRINT);
Per i tornei Burstein usa BursteinPairingEngine. Le classi di matching interne non appartengono all’API stabile.
04
Scegli JSON canonico o TRF26
Canonical JSON
Lo schema openpairing.tournament/1 contiene turno, sistema, punteggi, giocatori e storia.
Esempio JSON →TRF26
Il codec richiede il sistema nel record 192 e rifiuta input incompatibili o ambigui.
Supporto TRF26 →05
Verifica con PTC e genera casi con RTG
php bin/openpairing-ptc.php completed.trf > ptc-report.json
php bin/openpairing-rtg.php --players=80 --rounds=9 --seed=20260815 > generated.trf
php bin/openpairing-ptc.php generated.trf > generated-report.json