---
title: "Kontext vlákna — Messages for Laravel | Roundly"
description: "Priraďte konverzáciu firme, projektu či objednávke — jedna priama konverzácia na dvojicu a kontext, zoznamy podľa kontextu a háčik, ktorý v multi-tenant aplikácii nič nepustí."
url: https://roundly-consulting.com/sk/open-source/navody/messages-for-laravel/kontext-vlakna
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Messages for Laravel](https://roundly-consulting.com/sk/open-source/navody/messages-for-laravel.md)

# Kontext vlákna

Od verzie 2.2.0. Vlákno môže patriť kontextu — firme, projektu alebo objednávke, o ktorej sa konverzácia vedie. Poslúži akýkoľvek uložený model (neuložený vyhodí ThreadContextException::unsaved()), ak jeho typ kľúča zodpovedá key\_type. Je to voliteľné: vlákno bez kontextu sa správa presne ako doteraz.

```php
// Start in a context
$thread = Messages::start('Quote #812')->for($company)->withParticipants([$agent, $customer])->create();
$thread = $agent->startConversationWith($customer, 'Quote #812', context: $company);

// One DM per pair per context
$dm = Messages::direct($agent, $customer, $company);
$dm = $agent->conversationWith($customer, $company);

// Listing and lookup — each narrows to the context when given one
Messages::inboxFor($agent, context: $company);
Messages::threads($agent, context: $company);
Messages::unreadCount($agent, context: $company);
$agent->threads($company); $agent->unreadThreads($company); $agent->unreadCount(context: $company);

// Query scopes
Thread::query()->forContext($company)->get();
Thread::query()->withoutContext()->get();
$thread->context;                // the company (MorphTo)
$thread->isInContext($company);  // bool
```

- start()->for($context) založí vlákno v kontexte; startConversationWith() z traitu ho prijme ako context:.
- direct($a, $b, $context) a conversationWith($other, $context) držia jednu priamu konverzáciu na dvojicu a kontext, plus jednu bez kontextu: konverzácia v kontexte A sa nikdy nevráti pre kontext B ani bez kontextu. Kontext je súčasťou kľúča dvojice (Thread::directKeyFor($a, $b, $context)), takže vyhľadanie zostáva odolné voči súbehu.
- inboxFor(), threads() a unreadCount() — aj threads(), conversations(), unreadThreads() a unreadCount() z traitu — sa pri zadanom kontexte zúžia na jeden kontext.
- Thread::forContext($model) a Thread::withoutContext() sú bežné query scopes; Thread::between() zodpovedá akémukoľvek kontextu. $thread->context je MorphTo, $thread->isInContext(?Model) rýchla kontrola (null = nemá žiadny).

## Háčik, ktorý nič nepustí

V aplikácii pre viacero firiem urobte z kontextu hranicu: raz zaregistrujte resolver a kým vracia kontext, každý dopyt na vlákna je obmedzený presne na tento kontext:

```php
// AppServiceProvider::boot() — a closure …
Messages::resolveContextUsing(fn (): ?Company => app(CurrentCompany::class)->get());

// … or a class, resolved from the container (config:cache friendly)
// config/messages.php: 'context' => ['resolver' => App\Messaging\CurrentCompanyContext::class],
final class CurrentCompanyContext implements \RoundlyConsulting\Messages\Interfaces\ResolvesThreadContext
{
    public function currentContext(): ?Model { return app(CurrentCompany::class)->get(); }
}
```

- Čítanie — Thread::query(), find(), route-model binding, inboxFor(), threads(), unreadCount(), vyhľadanie v direct(), relácia thread správy či účastníka aj autorizácia broadcast kanála vlákna vidia len vlákna tohto kontextu (globálny scope ThreadContextScope). Vlákno iného kontextu, alebo vlákno bez kontextu, sa jednoducho nenájde.
- Držané inštancie — API odmietne vlákno iného kontextu, ktoré dostane, s ThreadContextException::outsideCurrentContext(): to(), send(), thread() a každá metóda handle za ním, markRead(), message(), unreadCount($p, $thread), prune(thread:) aj pomocné metódy modelov, ktoré cez ne idú.
- Zápis — start()->create() a direct() bez kontextu použijú aktuálny; žiadosť o iný vyhodí ThreadContextException::mismatch().
- Chybný resolver nikdy nevedie k neobmedzenému dopytu: closure, ktorá nevráti model ani null, vyhodí invalidResolution(), neuložený model unsaved(), zle nakonfigurovaná trieda InvalidConfigurationException.

Resolver, ktorý vráti null, nič neobmedzuje — konzolové príkazy, joby vo fronte, administrácia. Keď treba, vystúpte z neho výslovne:

```php
Messages::currentContext();                                    // ?Model — the context queries are limited to now
Messages::withoutContextScope(fn () => Thread::query()->count());  // the hook off for one block (admin, jobs)
Thread::withoutGlobalScope(ThreadContextScope::class)->get();  // or for one query
Messages::resolveContextUsing(null);                            // remove the closure
```

Resolver beží pri každom dopyte na vlákna, preto nech je lacný a nikdy v ňom nedopytujte vlákna (to vedie k rekurzii). Scope obmedzuje vlákna: samotné Message::find() a Participant::find() obmedzené nie sú — pristupujte k nim cez vlákno alebo cez Messages::message(), ktoré cudzie odmietne. prune() bez vlákna je údržba a čistí všetky kontexty. Háčik žije v singletone kontajnera, takže ho Messages::fake() zachová, a php artisan about ukáže Context scope: ON alebo OFF (INVALID pri zle nakonfigurovanej triede).

## V JSON

ThreadResource vykreslí context, len ak je relácia načítaná — $thread->load('context') alebo ->with('context'); vlastné zoznamy balíka ju nenačítavajú. Ide cez resources.context, predvolene ThreadContextResource, ktorý nikdy neukáže názov triedy:

```json
"context": { "id": 7, "type": "Company" }   // ThreadResource — only when the context relation is loaded; null for none
```

ThreadContextResource::configured(?Model $context) zostaví nakonfigurovaný resource. V testoch assertThreadCreated(context: $company) overí kontext, v ktorom vlákno vzniklo — zadaný alebo prevzatý z háčika.

## 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](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## 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](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/messages-for-laravel.md)
