Direktiva Blade hasStack v Laravelu a pokročilé ovládání zásobníku

Informatec Digital » Zdroje » Direktiva Blade hasStack v Laravelu a pokročilé ovládání zásobníku

Pokud pracujete s Laravelem denně, dříve či později se setkáte s Bladem, jeho direktivami a samozřejmě i s view stacky a myšlenkou hypotetické direktivy `hasStack` pro jejich lepší správu. Možná používáte klasické PHP šablony, nebo jste zvyklí na React či Vue, ale až skutečně pochopíte Blade a vše, co nabízí (včetně stacků), vaše organizace view udělá významný skok vpřed.

V tomto článku se ponoříme do složitostí: podrobně uvidíte , jak Blade funguje, co jsou řídicí direktivy, jak jsou strukturovány rozvržení, komponenty, sloty, atributy, autorizace a prostředí a v tomto kontextu, jak zapadají koncepty stacků a direktivy hasStack, které vám umožňují zkontrolovat naskládaný obsah před vykreslením. To vše bude ilustrováno praktickými příklady a realistickým přístupem navrženým pro moderní projekty Laravelu.

Co je Blade a proč je klíčové porozumět jeho směrnicím?

Čepel je oficiální šablonovací engine LaravelNenutí vás to přestat používat PHP, ale poskytuje vám to mnohem čistší syntaxi pro kombinování prezentační logiky a HTML bez neustálého otevírání a zavírání tagů. Pořád. Každá šablona. .blade.php Je zkompilován do čistého PHP a uložen v mezipaměti. storage/framework/views, takže režie za běhu je minimální.

Pohledy lopatek se obvykle ukládají do zdroje/názory a jsou vráceny z tras nebo kontrolerů pomocí pomocné metody view()Data můžete tomuto pomocníkovi předat v druhém argumentu (asociativní pole, compact()atd.) a v pohledu jsou spotřebovány syntaxí dvojité klíče pro zobrazení escapovaného obsahu nebo s vykřičníky pro neescapovaný obsah.

Hlavní výhodou Blade je, že nabízí specifické směrnice (slova, která začínají na @) pro zpracování podmíněných výrazů, smyček, autorizace, zásobníků skriptů, komponent, slotů, validace, prostředí… Díky tomu všemu je kód zobrazení mnohem čitelnější a lépe udržovatelný než chaotická směs klasického PHP s echo a prostý HTML.

Základní syntaxe Blade: echo, escape a verbatim

Nejtypičtější operací v zobrazení je zobrazení dat. V Blade stačí pro výpis obsahu proměnné použít {{ }}, což se interně promítá do echo e($variable) a proto, Escape HTML entity pro prevenci XSS:

Zobrazení escapovaných proměnných je jednoduché jako:

{{ $name }}

Pokud chcete zobrazit předgenerovaný HTML kód nebo obsah, který by neměl být escapován (například proto, že ho ovládáte a víte, že je bezpečný), můžete použít syntaxi {!! !!} , která zakáže automatické escapování a umožní prohlížeči interpretovat jej tak, jak je:

{!! $htmlSeguro !!}

Pokud pracujete s frontendovými frameworky, které také používají klíče (například Vue nebo nějaká klientská šablonovací knihovna), Blade vám to umožní „uniknout“ vlastnímu motoru s předponou @. Tímto způsobem @{{ proměnnáJavascript }} Nebude interpretován jako výraz Blade, ale zůstane v HTML, aby jej mohl zpracovat framework prohlížeče.

Pokud máte velké bloky, u kterých potřebujete plně respektovat dvojité složené závorky, aniž by se jich Blade dotýkal, můžete je obklopit direktivou @verbatim … @endverbatim . Všechno uvnitř zůstane nedotčeno, což je velmi užitečný nástroj při integraci složitých šablon frontendu.

Řídicí struktury: if, switch, smyčky a proměnná $loop

Blade nabízí kompletní sadu direktiv pro řízení toku , které zabalují syntaxi PHP srozumitelnějším a konzistentnějším způsobem. V praxi je logika téměř identická, ale získáte přehlednost a vyhnete se nadměrnému používání PHP tagů v HTML.

Příkazy if jsou psány s @if, @elseif, @else a blízko s @endifMáte také zkratky, jako například @unless (negace podmínky), @isset ověřit, zda je proměnná definována a @empty aby se zkontrolovalo, zda je prázdné.

Pro scénáře s více možnými hodnotami platí direktiva @přepínač replikuje strukturu PHP switch pomocí @case, @break, @default a uzavřít s @endswitch, což usnadňuje použití více podmíněných příkazů, které se snadno čtou.

Pokud jde o smyčky, máte @pro, @foreach y @zatímco, Plus @forelseTo je velmi užitečné, když chcete iterovat nad kolekcí, ale také potřebujete zpracovat případ prázdného seznamu bez psaní dalšího příkazu if. @forelse ... @empty ... @endforelse Pokud neexistují žádné prvky, můžete vykreslit alternativní obsah.

Když cestujete skrz @foreachBlade vám zpřístupňuje proměnnou $loop, objekt, který obsahuje velmi užitečné informace o aktuální iteraci: index, zda se jedná o první nebo poslední kolo, zda je index sudý nebo lichý, kolik iterací celkem existuje, nebo dokonce přístup k nadřazené smyčce v případě vnořených smyček používajících $loop->parent.

Dědičnost šablon, rozvržení a sekce

V reálných aplikacích nechcete opakovat záhlaví, nabídky nebo zápatí v každém zobrazení. Blade umožňuje definovat hlavní rozvržení (obvykle je uložen v) resources/views/layouts/master.blade.php), které dědí všechny stránky. V rámci rozvržení definujete „prázdné“ oblasti pomocí @yield a zbytek běžného HTML zůstává stabilní.

Chcete-li použít toto rozvržení z podřízeného zobrazení, stačí uvést @extends('layouts.master') a deklarujte sekce, které chcete vyplnit, pomocí @sekce y @endsection. Každý @yield('nombre') magisterský titul bude odpovídat @section('nombre') z pohledu dcery.

Direktiva @parent navíc umožňuje nejen přepsat sekci, ale také přidat obsah nad nebo pod to, co definuje rozvržení . To je velmi užitečné v postranních panelech nebo blocích, které chcete rozšířit, nikoli nahradit.

Pokud potřebujete zahrnout opakovaně použitelné úryvky HTML kódu bez úplné dědičnosti, Blade poskytuje @zahrnout a celou řadu souvisejících směrnic: @includeIf, @includeWhen, @includeUnless y @includeFirstkteré vám umožňují podmíněně zahrnout dílčí pohledy nebo vybrat první, který existuje v seznamu možných tras.

V případech, kdy opakujete malý fragment pro každý prvek kolekce, direktiva @each kombinuje foreach + include do jednoho řádku a může dokonce definovat alternativní zobrazení pro případ, kdy kolekce dorazí prázdná.

Komponenty, sloty a atributy čepele

Komponenty Blade jsou přirozeným vývojem rozvržení a zahrnují: umožňují zapouzdřit opakovaně použitelné prvky rozhraní (tlačítka, upozornění, karty, formuláře…) s vlastní logikou, vlastnostmi a sloty s obsahem, který lze vkládat zvenčí, to vše se syntaxí velmi blízkou moderním komponentám JS frameworku.

Existují dva hlavní typy komponent: třídní (nachází se v app/View/Components, generované pomocí php artisan make:component) a anonymníkteré jsou vidět pouze v resources/views/components bez přidružené třídy. V obou případech jsou vykresleny v zobrazeních s popisky typu <x-alert /> o <x-forms.input />.

Komponenty založené na třídách přijímají data prostřednictvím Atributy HTML (s kebab-case na dohled a camelCase v konstruktoru), jsou v zobrazení komponenty zobrazeny jako veřejné vlastnosti a mohou si zvolit metodu shouldRender() podmíněně rozhodnout, zda by měly být zobrazeny.

Pro flexibilní obsah komponenty obsahují slotyHlavní obsah je přístupný jako $slot v šabloně komponenty a sloty se jménem jsou definovány pomocí <x-slot name="titulo">...</x-slot> Při použití komponenty. Zevnitř můžete volat metody komponenty prostřednictvím $component a dokonce zkontrolovat, zda je slot prázdný pomocí $slot->isEmpty() nebo pokud má skutečný obsah $slot->hasActualContent().

Komponenty také elegantně zvládají další atributy které neodpovídají vlastnostem konstruktoru (například class, id, data-*To vše je seskupeno do přístupného „sbírky atributů“ s $attributeskteré můžete vykreslit tak, jak jsou, nebo manipulovat s metodami, jako například merge(), class(), prepend(), filter(), whereStartsWith(), has() o get().

Kromě toho Blade obsahuje specifické direktivy pro typický HTML formulář: @checked , @selected , @disabled , @readonly a @required , které vypíší odpovídající atribut pouze v případě, že podmínka, kterou obdrží, je vyhodnocena jako true.

Rozvržení s využitím komponent a klasické dědičnosti

V moderním Laravelu se stále častěji definuje globální rozvržení aplikace jako Součást čepele (například <x-layout>) namísto použití pouze klasické dědičnosti @extendsTímto způsobem může rozvržení přijímat sloty, atributy a vlastnosti stejně jako ostatní komponenty.

Typický vzorec zahrnuje vytvoření komponenty Nákres s php artisan make:component LayoutDefinujte základní strukturu HTML (záhlaví, odkazy CSS, navigace, zápatí) ve vaší šabloně a použijte ji {{ $slot }} pro vložení hlavního obsahu. Volitelně je definován pojmenovaný slot. title takže každá stránka deklarativním způsobem specifikuje svůj název.

Na druhou stranu stále existuje „klasická“ možnost. dědičnost šablon Vía @extends, @section y @yieldToto se široce používalo před popularizací komponent. Můžete i nadále kombinovat oba přístupy, používat rozvržení založené na komponentách pro vše, nebo se držet tradiční dědičnosti, pokud je váš projekt již takto nastaven.

V obou případech je cíl stejný: vyhnout se opakování HTML kostry v každém zobrazení , zachovat jediný bod pravdy pro rozvržení a umožnit každé stránce soustředit se výhradně na svůj specifický obsah.

Relace, autentizace, prostředí a autorizace v Blade

Blade se velmi dobře integruje se zbytkem frameworku, takže se neomezuje pouze na vykreslování HTML: nabízí také direktivy na vysoké úrovni pro interakci s relací, ověřovacím systémem, prostředím aplikace a autorizačními pravidly.

Pro ověřování existují direktivy jako @auth a @guest , které zobrazují svůj obsah pouze v případě, že je uživatel ověřen, respektive je host. Dále můžete jako argument zadat konkrétní parametr guard pro upřesnění použitého kontextu ověřování.

the směrnice o životním prostředí jak @production o @env('local') Umožňují nastavit podmínku pro sekce zobrazení v závislosti na aktuálním prostředí Laravelu. Velmi užitečné například pro zobrazování bannerů, ladicích stop nebo skriptů pouze v lokálním nebo testovacím prostředí.

Pokud jde o relace, direktiva @session usnadňuje kontrolu, zda existuje klíč relace, a pokud ano, poskytuje jeho hodnotu prostřednictvím proměnné $value . To elegantně řeší klasický případ bleskových zpráv nebo upozornění.

Pro autorizaci na základě zásad a bran nabízí Blade @pes, @nelze y @cananyS jejich pomocí můžete zobrazit nebo skrýt tlačítka, odkazy nebo celé bloky v závislosti na tom, zda má uživatel oprávnění k určité akci v modelu nebo třídě. V kombinaci s @guest o @authUmožňují konstrukci mnohem bezpečnějších a přehlednějších rozhraní.

Formuláře, ověřování a ošetřování chyb v zobrazeních

Když přejdete ze statických zobrazení na formuláře, skutečně uvidíte, jak pohodlný je Blade. Laravel vyžaduje, abyste do všech formulářů, které upravují data, zahrnuli token CSRF , a abyste se vyhnuli ručnímu zápisu skrytého pole, existuje direktiva `@csrf` , která generuje vstup s odpovídajícím tokenem.

HTTP metody, jako například VLOŽIT, ZÁPLATIT nebo ODSTRANIT Jsou simulovány pomocí skrytého pole _methoda Blade vám to zpřístupňuje @method('PUT') (nebo PATCH/DELETE) pro jeho automatické vygenerování ve formuláři.

Ukázat chyby ověření Směrnice existuje @chybakterý je přidružen ke konkrétnímu poli. V něm máte k dispozici proměnnou. $zpráva s textem chyby. Protože se ve skutečnosti jedná o kompilovaný příkaz if, můžete použít @else zobrazit alternativní obsah, pokud nedošlo k žádné chybě.

Objekt $chyby Je vždy přítomen v zobrazeních a seskupuje všechny ověřovací zprávy pro aktuální požadavek. Bezproblémově se integruje s pomocníkem. old(), což umožňuje po selhání ověření „znovu naplnit“ formulář hodnotami odeslanými uživatelem, přičemž se zadané položky zachovají a chyby se jasně zobrazí.

Kombinací těchto direktiv s ověřovacími pravidly v kontrolérech nebo formulářových požadavcích získáte robustní ověřovací tok na straně serveru , který doplňuje ověřování na straně klienta a je mnohem bezpečnější proti škodlivé manipulaci.

Zásobníky v Blade: @stack, @push, @prepend a koncept hasStack

Jednou z méně diskutovaných, ale pro velké projekty nejužitečnějších funkcí Blade jsou zásobníky (stacks ). Zásobník je v podstatě kolekce fragmentů zobrazení (view fragments), do kterých můžete přidávat obsah z podřízených zobrazení (views), komponent (components) nebo zahrnutých prvků (include) a poté je vše dohromady vykreslit v určitém bodě hlavního rozvržení (master layout).

Direktiva `@stack('name')` určuje, kam budou vloženy všechny fragmenty spojené s daným zásobníkem. Naproti tomu z jakéhokoli jiného pohledu můžete použít `@push('name')` k vložení obsahu na konec zásobníku nebo `@prepend('name') ` k jeho vložení na začátek. Toto se často používá pro skripty a styly specifické pro stránku.

Představte si například, že ve svém rozvržení máte něco takového v <head> a na konci <body>:

@stack('styles')
...
@stack('scripts')

Pak v konkrétním zobrazení, které vyžaduje další JS , můžete provést:

@push('scripts')
<script src="/js/pagina-especifica.js"></script>
@endpush

Díky tomu se rozvržení vyhne nutnosti znát každý skript nebo styl na každé stránce ; definuje pouze zásobníky a podřízené pohledy ukládají to, co potřebují. K dispozici je také `@pushIf` pro vložení obsahu na základě booleovské podmínky, aniž by bylo nutné psát celý příkaz `if`.

V tomto kontextu mnoho vývojářů přehlíží direktivu jako `@hasStack` nebo podobnou , která by jim umožnila zkontrolovat, zda daný zásobník obsahuje obsah před jeho vykreslením. Ačkoli Blade direktivu s tímto názvem předem neobsahuje, myšlenka je jasná: umožnit něco jako „pokud je zásobník skriptu prázdný, nevypisovat další popisky“ nebo „pokud jsou v zásobníku metadat prvky, zabalit je do specifického bloku“.

Způsob, jak dosáhnout ekvivalentního chování dnes, je doplňte direktivy zásobníku logikou v rozvržení nebo s vlastními pomocníky, nebo dokonce s našimi vlastními registrovanými direktivami prostřednictvím Blade::directive()Tímto způsobem lze simulovat direktivu hasStack, která interně dotazuje zásobník před rozhodnutím, který HTML kód vygenerovat.

JSON, JavaScript a pomocné direktivy v Blade

V mnoha Laravelových zobrazeních je potřeba předávat data z backendu do JavaScriptu. Obvykle to zahrnuje provedení json_encode() pole nebo kolekce a ponechat ho uvnitř inline skriptu, ale to není vždy bezpečné nebo pohodlné. Laravel to usnadňuje pomocí pomocníka Js::from(), který serializuje a správně escapuje hodnoty PHP do JSON pro vložení do HTML.

Když vykreslujete komplexní data do prohlížeče, Js::from() Vyhýbá se problémům s uvozovkami nebo speciálními znaky a vrací výraz JSON.parse() Bezpečné pro zahrnutí do atributů nebo skriptů. Předávání složitých výrazů v rámci direktivy se nedoporučuje, protože Blade interně používá regulární výrazy při jejich kompilaci, což může vést k neočekávaným problémům.

Blade dále umožňuje definovat komentáře šablon , které se nepředávají do finálního HTML kódu (na rozdíl od klasických HTML komentářů), a bloky @php … @endphp , kde můžete v nezbytně nutném případě spustit malé úryvky čistého PHP kódu. Dokonce můžete použít @use k importu tříd do zobrazení nebo k jejich přiřazení aliasů, což je praktické při práci s pomocníky nebo velmi specifickými komponentami.

Pokud se dostanete do bodu, kdy potřebujete vysoce specializovanou funkci echo pro určité objekty, můžete zaregistrovat vlastní obslužné rutiny ozvěny s Blade::stringable()takže při odesílání ozvěny konkrétního objektu Blade volá vaši zpětnou volbu místo metody Magic __toString() třídy.

Zobrazení chyb, fragmenty a vlastní direktivy

Laravel vám umožňuje přizpůsobit zobrazení chybjednoduše vytvořte soubory v resources/views/errors s kódem HTTP jako názvem (například 404.blade.php o 500.blade.phpPokaždé, když k této chybě dojde, bude použita vaše šablona místo generické šablony z frameworku.

V případech, kdy pracujete s nástroji jako Turbo nebo htmlx a chcete se jen vrátit konkrétní fragmenty pohleduBlade nabízí směrnice @fragment … @endfragment v kombinaci s metodami, jako je view('...')->fragment('nombre'), fragmentIf(), fragments() y fragmentsIf()Tímto způsobem můžete znovu použít celou stejnou šablonu a v závislosti na kontextu extrahovat pouze ty části, které potřebujete.

Pokud vám repertoár direktiv nestačí, můžete si vždy vytvořit vlastní pomocí Blade::direktiva()Obvyklá praxe je registrovat je pomocí metody boot() de AppServiceProvider nebo prostřednictvím vyhrazeného poskytovatele. Kompilátor Blade vám předá výraz uvnitř direktivy jako řetězec a vy vrátíte PHP kód, který chcete při kompilaci vygenerovat.

Pro jednoduché přizpůsobené podmínky je k dispozici také Čepel::if()což vytváří podmíněné direktivy v jednom řádku. Můžete například definovat @disk('s3') zkontrolovat, zda je výchozí disk aplikace S3, a poté jej použít v libovolném zobrazení, jako by se jednalo o nativní direktivu.

S tímto arzenálem si můžete vytvořit jazyk šablon prakticky přizpůsobený vašim potřebám , včetně direktivy typu hasStack, pokud chcete, která funguje jako syntaktický cukr v logice, jež interně kontroluje, zda zásobník má obsah, než jej vypíše.

Hloubkové zvládnutí Blade – od základní syntaxe až po pokročilé komponenty, autorizační direktivy, validaci, prostředí a především správu zásobníků – vám umožní vytvářet modulární, bezpečné, konzistentní a snadno udržovatelné pohledy , kam by se přirozeně hodila budoucí direktiva jako hasStack, která by dále rozšířila kontrolu nad tím, co se vkládá do každé oblasti vašeho rozvržení.