Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é Blade?

    O Blade monta o HTML no servidor a partir de arquivos .blade.php. As diretivas geram PHP compilado e em cache, sem deixar a sintaxe no código executado.

    Também chamado de: Blade templates, templates Blade

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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>
    @endforelse

    O @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>
    @endsection

    O @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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano