Pomenované skupiny

Kredity jednej entity sa dajú rozdeliť do nezávislých pomenovaných skupín (buckets) — napríklad promo a zakúpené kredity, ktoré sa nesmú navzájom miešať. Na fasáde scope zúžite cez bucket(); buckets([...]) sčíta viacero skupín na čítanie:

$promo = Credits::for($user)->bucket('promotional');   // an immutable scope — keep and reuse it
$promo->add(100, 'welcome promo');
$promo->balance();                                     // 100

Credits::for($user)->bucket('purchased')->add(50, 'top-up');

Credits::for($user)->buckets(['promotional', 'purchased'])->balance(); // 150 — summed, read-only
Credits::for($user)->total();                                          // every bucket

Každá metóda traitu prijíma rovnaký voliteľný argument bucket:

$user->modifyCredits(100, 'welcome promo', bucket: 'promotional');
$user->modifyCredits(50, 'top-up', bucket: 'purchased');

$user->creditsBalance(bucket: 'promotional'); // 100
$user->creditsBalance(bucket: 'purchased');   // 50

Zostatky sú v každej skupine úplne izolované a ochrana pred prečerpaním platí pre každú skupinu zvlášť — odpis zo skupiny purchased nesiahne na promo kredity.

Predvolená skupina

Keď skupinu neuvediete, na čítanie aj zápis sa použije nakonfigurovaná default_bucket („default“). Zostatok bez skupiny preto vráti len predvolenú skupinu — nesčítava všetky skupiny:

$user->modifyCredits(25);                         // lands in the 'default' bucket
$user->creditsBalance();                          // 25  (the default bucket only)
$user->creditsBalance(bucket: 'promotional');     // 100

Používanie jedného fondu nevyžaduje žiadne zmeny: každé volanie bez skupiny pracuje s jedným fondom. setCreditsTo() a hasCredits() prijímajú rovnaký argument bucket a credits:modify má voľbu --bucket=.

Súčty naprieč skupinami

Keď naozaj potrebujete spoločné číslo, sčítajte vybrané skupiny alebo všetky skupiny entity:

// Sum a chosen set of buckets (names are de-duplicated; an empty list returns 0).
$user->creditsBalanceForBuckets(['promotional', 'purchased']); // 150

// Sum every bucket on the entity.
$user->totalCreditsBalance(); // 175

// Both accept an optional point-in-time argument.
$user->totalCreditsBalance(now()->subWeek());
$user->creditsBalanceForBuckets(['promotional', 'purchased'], now()->subWeek());

Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

Ďalšie spôsoby podpory vrátane kryptomien

Odoslaním daru súhlasíte s našimi podmienkami prijímania darov.

Podporte našu open-source prácu Pridajte sa k nám na Patreone

Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

Ponuka do 48 hodín Prezrieť všetky balíky