Konfigurácia

Publikovaný config/likes.php bez komentárov:

use RoundlyConsulting\Likes\Models\Like;

return [
    'model' => Like::class,
    'table' => env('LIKES_TABLE', 'likes'),
    'key_type' => env('LIKES_KEY_TYPE', 'bigint'),
    'reactions' => ['like'],
    'default_reaction' => env('LIKES_DEFAULT_REACTION', 'like'),
    'actor_resolver' => null,
    'facade_alias' => env('LIKES_FACADE_ALIAS', 'Likes'),

    'weights' => [
        // 'like' => 1,
        // 'love' => 4,
    ],
    'default_weight' => 1,

    'trending' => [
        'window' => '7 days',
        'recent_multiplier' => 3,
        'driver_expressions' => [
            // 'pgsql' => 'SUM(1 / POWER(EXTRACT(EPOCH FROM (NOW() - created_at)) / 3600 + 2, 1.8))',
        ],
    ],

    'broadcast' => [
        'enabled' => env('LIKES_BROADCAST', false),
        'channel_prefix' => 'likes',
        'channel_type' => 'private',
    ],
];

Všetky kľúče

Kľúč, ktorý nie je nastavený — chýba, je null alebo je prázdny ako riadok LIKES_TABLE= v hostiteľskej aplikácii —, použije svoju predvolenú hodnotu (prázdny výraz pre driver: prenosné skóre). Nastavená hodnota musí sedieť: nereťazcové table, default_reaction, trending.window či broadcast.channel_prefix, zoznam reactions, ktorý je prázdny alebo obsahuje nereťazec, nečíselná váha, násobiteľ či predvolená váha, výraz pre driver, ktorý nie je reťazec, alebo preklep v broadcast.channel_type — ten sa už nečíta ako private — vyhodí InvalidConfigurationException, namiesto aby sa použila predvolená hodnota alebo sa nastavenie zahodilo.

Prostredie (env)

Kľúče citlivé na nasadenie sa čítajú z env, takže konfiguráciu publikujete len zriedka:

LIKES_TABLE=likes
LIKES_KEY_TYPE=bigint
LIKES_DEFAULT_REACTION=like
LIKES_FACADE_ALIAS=Likes
LIKES_BROADCAST=false

Pravidlá, ktoré sa oplatí poznať

• table a key_type sa čítajú pri spustení migrácie — nastavte ich pred migrovaním.
• default_reaction musí byť v reactions; inak každé volanie bez explicitného typu vyhodí InvalidReactionTypeException.
• Closure v actor_resolver funguje, no Laravel nedokáže uložiť do cache konfiguráciu s closures — pri php artisan config:cache uprednostnite invokovateľnú triedu.
• Broadcasting je vypnutý, kým broadcast.enabled nie je true; vaše listenery udalosti dostanú v každom prípade.