Kas yra Laravel fasadai?

Question

Accepted Answer

**Fasadai** suteikia švarią, statiškai panašią sąsają klasėms iš paslaugų konteinerio — pvz. `Cache::get()`, `DB::table()`, `Route::get()`. Jie atrodo kaip statiniai metodų iškvietimai, bet iš tikrųjų **perduoda iškvietus objektams, kurie išsprendžiami iš konteinerio**, derindami statinės sintaksės patogumą su priklausomybės įprasminio testų sugebamumu.

## Fasadai atrodo statiniai, bet jais nėra

```php
use Illuminate\Support\Facades\Cache;

Cache::put('key', 'value', 60);     // looks like a static call...
Cache::get('key');

// ...but under the hood it proxies to a container-resolved cache instance.
// Equivalent to: app('cache')->put('key', 'value', 60);
```

Fasadas nėra tikra statinė klasė — jis perduoda iškvietus tikrą objektą, išsprendžiamą iš paslaugų konteinerio. Todėl gaunate švarią, patogią sintaksę, o tikrasis darbas atliekamas per injekcinę, nusimokstamą tarnybą.

## Dažniausi fasadai

```php
DB::table('users')->get();           // database
Cache::remember('stats', 60, fn() => compute());   // caching
Auth::user();                         // authentication
Route::get('/', ...);                 // routing
Log::info('message');                 // logging
Storage::put('file.txt', $content);   // filesystem
Mail::to($user)->send(new Welcome()); // mail
Validator::make($data, $rules);       // validation
```

Fasadai suteikia lengvai įsimenimą, išraiškinį API Laravel paslaugoms — tai yra rėmės "elegantiškos sintaksės" dalis.

## Fasadai yra testuojami (skirtingai nei tikriniai statiniai)

```php
// you can MOCK a facade in tests (impossible with true static methods)
Cache::shouldReceive('get')->with('key')->andReturn('value');
Mail::fake();                          // assert mail was sent without sending it
Mail::assertSent(WelcomeEmail::class);
```

Badangi fasadai perduoda iškvietus konteinerio objektams, Laravel gali testuojant sukeitį jais šalutinius (mock) — `Cache::shouldReceive(...)`, `Mail::fake()` — tai, ko negali padaryti tikriniai statiniai metodai.

## Fasadai ir priklausomybės injeksija

```text
Facade → convenient static-like syntax (Cache::get()), great for quick access
DI (constructor injection) → explicit dependencies, clearer for testing/coupling
→ Both resolve from the container; facades are sugar. Use DI when you want explicit
  dependencies; facades for concise access. (Some prefer DI for clarity.)
```

## Kodėl tai svarbu

Fasadai yra išskirtinis ir plačiai paplitęs Laravel bruožas — jie pasirodo visame Laravel kode (`DB::`, `Cache::`, `Auth::`, `Route::` ir t.t.), todėl jų supratimas yra svarbus skaitant ir rašant Laravel programas.

Pagrindinė idėja yra ta, kad fasadai **atrodo kaip statiniai iškvietimai, bet iš tikrųjų perduoda iškvietimus objektams, kurie išsprendžiami iš paslaugų konteinerio** — tai suteikia jums patogią, išraiškinę statiškai panašią sintaksę, kuri yra Laravel patrauklumo dalis, išsaugodami priklausomybės injeksijos naudas po žemiau (tikrasis darbas atliekamas injekcinės, nusimokstamos paslaugos pagalba).

Įsiminę, kad fasadai yra **testuojami** nepaisant jų statinio išvaizdos: Laravel gali sukeitį šalutinius (mock) (`Cache::shouldReceive()`, `Mail::fake()`) — tai neįmanoma su tikriniais statiniais metodais, kurie yra žinomi kaip itin sunkiai testuojami.

Supratimas, kaip fasadai veikia (konteinerio pralaidumas), dažniausi fasadai, jų testumas ir **kompromisas su aiškia priklausomybės injekcija** (fasadai greitam prieigai vs konstruktoriaus injeksija aiškioms, kontekstiškai lengviem priklausomybėms — abu tinkami, išsprendžiami iš to paties konteinerio) yra svarbus žinojimas veikiant efektyviai su Laravel ir priimant informuotus architektūrinius sprendimus.

Kadangi fasadai yra vienas iš labiausiai pažįstamų Laravel bruožų ir yra naudojami pastoviai, jų demistifikacija (jie nėra magija, statiniai bet konteinerio pralaidumas) ir žinojimas, kada juos naudoti palyginti su priklausomybės injekcija, parodo tvirtą rėmės supratimą ir padeda rašyti švarias, testuojamas Laravel programas.