Konfigurácia

Balík má rozumné predvolené hodnoty a funguje bez akejkoľvek konfigurácie. Publikovaný config/coupons.php v plnom znení:

use RoundlyConsulting\Coupons\Models\Coupon;

return [
    'model' => Coupon::class,

    // Key type of the polymorphic redeemer column: "bigint", "uuid" or "ulid".
    'key_type' => env('COUPONS_KEY_TYPE', 'bigint'),

    'default_currency' => env('COUPONS_CURRENCY', 'USD'),

    'redeemer' => [
        'track' => env('COUPONS_TRACK_REDEEMERS', true),
    ],

    'code' => [
        'length' => env('COUPONS_CODE_LENGTH', 6),
        'charset' => env('COUPONS_CODE_CHARSET', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'),
    ],

    'route_key' => env('COUPONS_ROUTE_KEY', 'code'),
];

Všetky kľúče

Prostredie (env)

Každý kľúč okrem model sa dá nastaviť cez env, takže konfiguráciu publikujete len zriedka:

COUPONS_KEY_TYPE=bigint
COUPONS_CURRENCY=EUR
COUPONS_TRACK_REDEEMERS=true
COUPONS_CODE_LENGTH=8
COUPONS_CODE_CHARSET=ABCDEFGHJKLMNPQRSTUVWXYZ23456789
COUPONS_ROUTE_KEY=code

COUPONS_TRACK_REDEEMERS prijíma hodnoty v štýle env: 1, true, on alebo yes sledovanie ponechajú zapnuté, 0, false, off alebo no ho vypnú; prázdna hodnota (COUPONS_TRACK_REDEEMERS=) sa považuje za nenastavenú, takže sledovanie zostáva zapnuté. Čokoľvek iné vyhodí InvalidConfigurationException s názvom kľúča.

Kľúč, ktorý odstránite, nastavíte na null alebo necháte prázdny (COUPONS_CURRENCY=), sa považuje za nenastavený a dostane predvolenú hodnotu; kľúč s hodnotou nesprávneho tvaru vyhodí výnimku, namiesto návratu k predvolenej hodnote, a php artisan about zobrazí chybný route_key, default_currency či hodnotu code.* ako INVALID aj s dôvodom. Nepoužiteľné code.length alebo code.charset vyhodí InvalidCouponConfiguration v momente generovania kódu — pozrite si Generované kódy; route_key či default_currency, ktorý nie je reťazcom, ju vyhodí pri čítaní. key_type sa číta len pri spustení migrácie.