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
Stato trasparente: OpenPairing è software open source con verifiche interne pubblicabili. Nessuna pagina dichiara o implica una certificazione FIDE non ancora ottenuta.