O Blade é o motor de templates incluído no Laravel. Ele lê arquivos com a extensão .blade.php na pasta resources/views e gera o HTML da resposta. A sintaxe mistura HTML com diretivas curtas, que o framework compila para PHP comum.
O arquivo compilado fica em cache. Na primeira renderização, o Blade traduz o template, e nas seguintes o Laravel usa a versão compilada até o arquivo original mudar. Por isso a sintaxe do template não é interpretada a cada acesso.
Impressão com escape
A forma mais comum de imprimir um valor usa chaves duplas:
<h1>Olá, {{ $usuario->nome }}</h1>O Blade escapa caracteres especiais do valor antes de imprimir. Um nome com <script> aparece como texto, não como código executado. Essa proteção cobre o caso comum de conteúdo digitado por um usuário.
A sintaxe {!! $html !!} imprime o valor sem escape. Ela serve para conteúdo que já foi sanitizado, como um trecho de Markdown convertido em HTML confiável. Usar essa sintaxe com texto de formulário abre uma falha de XSS. A escolha entre as duas precisa acompanhar a origem do valor.
Diretivas de controle e repetição
As diretivas cobrem o que seria um bloco de PHP no meio do HTML. Um @if abre uma condição e @endif fecha. Um @foreach percorre uma coleção, e @forelse trata também o caso vazio:
@forelse ($faturas as $fatura) <li>{{ $fatura->numero }} | {{ $fatura->total }}</li>@empty <li>Nenhuma fatura encontrada.</li>@endforelseO @empty evita uma lista vazia sem explicação. O mesmo cuidado aparece nos estados de erro de um formulário, com @error exibindo a mensagem do campo.
Layouts, inclusões e componentes
Um layout guarda a estrutura comum, como cabeçalho e rodapé. As telas estendem o layout e preenchem seções:
@extends('layouts.app')
@section('conteudo') <h1>Faturas</h1>@endsectionO @include reaproveita um trecho pequeno. Os componentes vão além: recebem propriedades e slots, o que permite tratar um botão ou um card como uma peça com contrato próprio. A escolha entre include e componente acompanha a necessidade de parâmetros e de estilo isolado.
Formulários e CSRF
Todo formulário que altera estado no Laravel precisa do token CSRF. A diretiva abaixo inclui o campo oculto com o token:
<form method="POST" action="/faturas"> @csrf ...</form>Sem esse campo, a requisição é recusada pela proteção do framework. A diretiva não substitui a validação dos campos nem a autorização da ação. Ela confirma que o formulário foi gerado pela aplicação, não que o usuário tem permissão para gravar aquele registro.
O limite do Blade
O Blade produz HTML no servidor. Ele não mantém estado no navegador nem responde a eventos sem uma nova requisição. Para uma parte interativa, o projeto pode usar JavaScript, Livewire ou um framework de frontend. A renderização no servidor continua sendo o ponto de partida da página.
A escolha não muda a política de escaping. Seja qual for a camada que monta a tela, o texto vindo de um usuário precisa ser tratado antes de virar HTML. O template é um dos pontos onde essa política aparece.
Dúvidas frequentes
Perguntas frequentes sobre Blade
- O Blade é uma linguagem nova que roda no navegador?
- Não. O Blade é uma sintaxe de template processada no servidor. Ela gera PHP comum, que produz o HTML enviado ao navegador. O navegador recebe apenas o resultado.
- Qual é a diferença entre e as chaves duplas?
- As chaves duplas escapam o valor antes de imprimir, o que evita que um texto digitado por um usuário vire HTML executado. A sintaxe sem escape imprime o conteúdo cru e só deve ser usada com conteúdo confiável.
- Blade e Livewire são a mesma coisa?
- Não. O Blade monta a página no servidor. O Livewire acrescenta componentes interativos que conversam com o servidor sem recarregar a página. Um projeto pode usar os dois.
Para continuar
Recursos relacionados
Documentação
Laravel: templates Blade
Cobre escaping, diretivas, layouts, componentes, slots e a compilação dos templates em PHP.
Abrir recursoDocumentação
Laravel: proteção CSRF
Explica o token que acompanha formulários e a diretiva usada dentro do template para incluí-lo.
Abrir recursoSite de referência
Promovaweb: o que é o Laravel
Mostra onde o Blade entra no ciclo da requisição e como ele se compara a uma interface em React ou Vue ligada pelo Inertia.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar uma tela gerada no Laravel, você confere o template Blade, a escaping da saída e o formulário com o token CSRF antes de publicar.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.