DI a akcie

Fasáda je odporúčaná voľba, nie jediná cesta. Balík ponúka tri rovnocenné vstupné body a všetky spúšťajú ten istý kód:

• Fasáda Coupons — najkratší zápis, odporúčaný na bežné volania.
• Manažér RoundlyConsulting\Coupons\CouponManager — koreň fasády. Injektujte ho cez konštruktor a získate rovnaké API ako explicitnú závislosť, bez statických volaní.
• Akcie — jednoúčelové triedy v RoundlyConsulting\Coupons\Actions s jedinou metódou execute(), ktoré skladáte do vlastných akcií, jobov a príkazov.

Injektovanie manažéra

use RoundlyConsulting\Coupons\CouponManager;
use RoundlyConsulting\Coupons\DataTransferObjects\RedemptionResult;
use RoundlyConsulting\Money\Money;

final class ApplyCoupon
{
    public function __construct(private CouponManager $coupons) {}

    public function __invoke(string $code, Money $cart, User $user): RedemptionResult
    {
        return $this->coupons->code($code)->redeem($cart, $user);
    }
}

Coupons::fake() nahradí manažéra pre fasádu aj pre každý injektovaný CouponManager — manažér nie je final, aby ho fake mohol rozšíriť —, takže triedu s injektovaným manažérom testujete rovnako ako triedu, ktorá volá fasádu.

Spustenie akcie

Každá operácia je aj samostatná trieda akcie, ktorú si môžete vyžiadať z kontajnera a spustiť sami. Väčšina berie bežné argumenty; CreateCouponAction berie DTO CreateCouponData a RedeemCouponAction DTO RedeemCouponData:

use RoundlyConsulting\Coupons\Actions\{CheckCouponAction, CreateCouponAction, ExpireCouponsAction,
    PruneCouponsAction, RedeemCouponAction, RevokeCouponAction};
use RoundlyConsulting\Coupons\DataTransferObjects\RedeemCouponData;

app(CreateCouponAction::class)->execute($data);                  // Coupon; quiet: true skips CouponCreated
app(CheckCouponAction::class)->execute('SUMMER', $cart, $user);   // ?RedemptionFailureReason
app(RedeemCouponAction::class)->execute(new RedeemCouponData(coupon: 'SUMMER', price: $cart, redeemer: $user));
app(RevokeCouponAction::class)->execute($coupon);
app(ExpireCouponsAction::class)->execute();                       // int
app(PruneCouponsAction::class)->execute(days: 30, force: false);  // int

Manažér si akciu vyžiada z kontajnera až pri volaní metódy. Akcia, ktorú spustíte sami, manažéra obíde, takže ju Coupons::fake() nezaznamená — v testoch preto overujte databázu a udalosti. Model Coupon, trait HasCoupons, pravidlo Redeemable aj oba Artisan príkazy idú cez manažéra.

Metóda fasády → akcia