Installation
tilttek/bountiesPrérequis
- PHP 8.5 ou une version plus récente, avec
sodium. phil/resource0.1, dontResourceReferencenomme chaque membre par la référence stable que lui donne le site, ainsi que le sujet de chaque prime.tilttek/points0.1 ou 0.2, pour le séquestre sur son registre et pourInsufficientPoints.psr/clocketsymfony/clock, pour l'heure de chaque mouvement ;psr/event-dispatcher, pour les événements.
Installer
composer require tilttek/bounties
Brancher la bibliothèque
Bounties reçoit deux ports, et au besoin un répartiteur d'événements, les règles du site et une horloge :
use Symfony\Component\Clock\NativeClock;
use Tilttek\Bounties\Bounties;
use Tilttek\Bounties\BountyRules;
use Tilttek\Bounties\Escrow\PointsBountyEscrow;
$bounties = new Bounties(
$store, // Contract\BountyStore: where the bounties are kept
new PointsBountyEscrow($points), // Contract\BountyEscrow: where the points are held, here the ledger of tilttek/points
$dispatcher, // Psr\EventDispatcher\EventDispatcherInterface, or null to dispatch nothing
new BountyRules(), // length, grace, smallest and largest bounty
new NativeClock(), // Psr\Clock\ClockInterface: the time of each move, kept in UTC
);
BountyRules reçoit, en secondes, la plus courte prime — un jour par défaut, une heure au moins —, la plus longue —
trente jours par défaut, quatre-vingt-dix au plus —, le délai de grâce après la fin pendant lequel le commanditaire
attribue encore — un jour par défaut, une semaine au plus —, puis le plus petit et le plus grand montant, 10 et 10 000
points par défaut.
Bounties ne conserve rien entre deux appels : une seule instance sert toutes les requêtes d'un worker. Lancez
expireDue() depuis une tâche planifiée, toutes les quelques minutes : elle règle les primes dont le délai de grâce est
passé, 100 à la fois par défaut et 500 au plus.