Konfigurácia

Balík funguje aj bez publikovanej konfigurácie. Celý súbor config/requests.php:

// config/requests.php
return [
    'model' => RoundlyConsulting\Requests\Models\Request::class,

    // bigint, uuid or ulid — the key type of the polymorphic author column
    'key_type' => env('REQUESTS_KEY_TYPE', 'bigint'),

    'enforce_transitions' => false,
    'default_ttl' => null,
    'register_facade_alias' => true,
];

Všetky kľúče

Prostredie (env)

Z env sa číta iba typ kľúča autora — nastavte ho pred spustením migrácie, keďže určuje stĺpec author_id:

REQUESTS_KEY_TYPE=uuid

Hodnoty z env() prichádzajú ako reťazce a balík ich podľa toho číta: '60' je TTL 60 minút a 'true'/'1'/'on'/'yes' (alebo 'false'/'0'/'off'/'no') prepínajú oba prepínače. Prázdna hodnota ('' či len medzery, samotný riadok KEY=) sa považuje za nenastavenú a platí predvolená. Akákoľvek iná hodnota prepínača vyhodí InvalidConfigurationException namiesto toho, aby sa potichu použila predvolená.

Vlastný model žiadosti

Rozšírte balíkový model o relácie, accessory či vlastné správanie a nasmerujte naň requests.model. Builder, relácie autora aj príkaz requests:expire používajú nakonfigurovanú triedu:

namespace App\Models;

use RoundlyConsulting\Requests\Models\Request;

class ExpenseClaim extends Request
{
    // Keep the package table — a subclass would otherwise look for "expense_claims".
    protected $table = 'requests';
}

// config/requests.php
'model' => App\Models\ExpenseClaim::class,

Nakonfigurovaná trieda musí byť RoundlyConsulting\Requests\Models\Request alebo jeho podtrieda — nič iné by nevedelo obslúžiť scopy, životný cyklus stavov ani schvaľovanie. Cudzí model — alebo neexistujúca trieda — vyhodí InvalidConfigurationException s názvom requests.model a nikdy sa potichu nenahradí balíkovým modelom.

Nastavenia schvaľovacieho enginu

Mechanika schvaľovania — pravidlá, viacstupňové schvaľovanie, delegovanie, expirácia a pomenované predvoľby workflowov — sa nastavuje v config/approvals.php, ktorý patrí balíku approvals-for-laravel. Publikujte ho tagom approvals-config, keď chcete definovať predvoľby workflowov.