README

Unified PHP draw engine with a single request/response contract for item, user, and campaign draw methods.

Campaign state uses PSR-6 (Psr\Cache\CacheItemPoolInterface) via options.cachePool.

Install

Requirements:

• PHP 8.2+
• ext-bcmath

composer require infocyph/game-draw

Quick Example

<?php
use Infocyph\Draw\Draw;

$draw = new Draw();

$result = $draw->execute([
    'method' => 'lucky',
    'items' => [
        ['item' => 'gift_a', 'chances' => 10, 'amountMode' => 'list', 'amounts' => [1, 2]],
        ['item' => 'gift_b', 'chances' => 20, 'amountMode' => 'weighted', 'amounts' => ['5' => 0.25, '10' => 0.75]],
    ],
    'options' => ['count' => 2],
]);

Supported Methods

• lucky
• grand
• probability, elimination, weightedElimination, roundRobin, cumulative
• batched, timeBased, weightedBatch, sequential, rangeWeighted
• campaign.run, campaign.batch, campaign.simulate

Security

Protected by PHPForge — an automated quality and security gate for PHP projects.