source_url | revision | status |
---|---|---|
8332d20b07cc639995649a335620b044151e6dd1 |
ready |
Para te dar uma vantagem inicial na construção da sua nova aplicação Laravel, temos o prazer de oferecer kits de autenticação e aplicações para iniciantes. Esses kits geram automaticamente o código com as rotas, controladores e visualizações necessários para registrar e autenticar as pessoas usuárias da sua aplicação.
Embora você possa usar esses kits para iniciantes, eles não são obrigatórios. Você está livre para construir sua própria aplicação do zero, simplesmente instalando uma nova cópia do Laravel. De qualquer forma, sabemos que você construirá algo incrível!
O Laravel Breeze é uma implementação mínima e simples de todos os recursos de autenticação do Laravel, incluindo login, registro, redefinição de senha, verificação de e-mail e confirmação de senha. Além disso, o Breeze inclui uma página simples de perfil onde a pessoa usuária pode atualizar seu nome, endereço de e-mail e senha.
A camada de visualização padrão do Laravel Breeze é composta de templates Blade simples estilizados com Tailwind CSS. Além disso, o Breeze oferece opções de geração de código baseado no Livewire ou Inertia, com a opção de usar Vue ou React para o código gerado baseado no Inertia.
Se você está começando agora no Laravel, sinta-se à vontade para entrar no Laravel Bootcamp. O Laravel Bootcamp irá orientá-lo na construção da sua primeira aplicação Laravel usando o Breeze. É uma ótima maneira de conhecer tudo o que o Laravel e o Breeze têm a oferecer.
Primeiro, você deve criar uma nova aplicação Laravel. Se você criar sua aplicação usando o instalador do Laravel, será solicitado que você instale o Laravel Breeze durante o processo de instalação. Caso contrário, você precisará seguir as instruções de instalação manual abaixo.
Se você já criou uma nova aplicação Laravel sem um kit para iniciante, você pode instalar manualmente o Laravel Breeze usando o Composer:
composer require laravel/breeze --dev
Após o Composer instalar o pacote Laravel Breeze, você deve executar o comando
breeze:install
do Artisan.
Este comando publicará as visualizações, rotas, controladores e outros recursos
de autenticação na sua aplicação.
O Laravel Breeze publica todo o código na sua aplicação para que você tenha
total controle e visibilidade sobre seus recursos e implementação.
O comando breeze:install
solicitará a sua stack front-end e framework de
testes preferidos:
php artisan breeze:install
php artisan migrate
npm install
npm run dev
A stack padrão Breeze é a stack Blade, que utiliza
templates Blade simples para renderizar o front-end da sua
aplicação.
A stack Blade pode ser instalada invocando o comando breeze:install
sem
argumentos adicionais e selecionando a stack front-end Blade.
Após a instalação do código gerado pelo Breeze, você também deve compilar os
ativos do front-end da sua aplicação:
php artisan breeze:install
php artisan migrate
npm install
npm run dev
Em seguida, você pode navegar até as URLs /login
ou /register
da sua
aplicação no seu navegador web.
Todas as rotas do Breeze são definidas no arquivo routes/auth.php
.
Nota: Para saber mais sobre como compilar o CSS e o JavaScript da sua aplicação, confira a documentação do Vite do Laravel.
O Laravel Breeze também oferece geração de código do Livewire. O Livewire é uma maneira poderosa de construir interfaces de pessoas usuárias front-end dinâmicas e reativas usando apenas PHP.
O Livewire é uma ótima opção para equipes que usam principalmente templates Blade e procuram uma alternativa mais simples para frameworks SPA baseados em JavaScript, como Vue e React.
Para usar a stack Livewire, você pode selecionar a stack front-end Livewire
ao executar o comando breeze:install
do Artisan.
Após a instalação do código gerado pelo Breeze, você deve executar as migrações
do seu banco de dados:
php artisan breeze:install
php artisan migrate
O Laravel Breeze também oferece geração de código React e Vue por meio de uma implementação de front-end do Inertia. O Inertia permite que você crie aplicações React e Vue modernas e de página única usando roteamento e controladores clássicos do lado do servidor.
O Inertia permite que você aproveite o poder de front-end do React e Vue
combinado com a incrível produtividade de back-end do Laravel e a compilação
extremamente rápida do Vite.
Para usar uma stack Inertia, você pode selecionar as stacks front-end Vue ou
React ao executar o comando breeze:install
do Artisan.
Ao selecionar a stack front-end Vue ou React, o instalador do Breeze também solicitará que você determine se deseja suporte para SSR com Inertia ou TypeScript. Após a instalação do código gerado pelo Breeze, você também deve compilar os ativos de front-end da sua aplicação:
php artisan breeze:install
php artisan migrate
npm install
npm run dev
Em seguida, você pode navegar até as URLs /login
ou /register
da sua
aplicação no seu navegador web.
Todas as rotas do Breeze são definidas no arquivo routes/auth.php
.
O Laravel Breeze também pode gerar o código de uma API de autenticação pronta
para autenticar aplicações JavaScript modernas, como aquelas baseadas em
Next, Nuxt, e outros.
Para começar, selecione a stack de API como a stack desejada ao executar o
comando breeze:install
do Artisan:
php artisan breeze:install
php artisan migrate
Durante a instalação, o Breeze adicionará uma variável de ambiente
FRONTEND_URL
ao arquivo .env
da sua aplicação.
Esta URL deve ser a URL da sua aplicação JavaScript.
Normalmente será http://localhost:3000
durante o desenvolvimento local.
Além disso, você deve garantir que sua APP_URL
esteja definida como
http://localhost:8000
, que é a URL padrão usada pelo comando serve
do
Artisan.
Finalmente, você está pronto para parear este back-end com o front-end de sua escolha. Uma implementação de referência Next do front-end Breeze está disponível no GitHub. Este front-end é mantido pelo Laravel e contém a mesma interface de pessoa usuária que as stacks Blade e Inertia tradicionais fornecidas pelo Breeze.
Embora o Laravel Breeze forneça um ponto de partida simples e mínimo para a construção de uma aplicação Laravel, o Jetstream aumenta essa funcionalidade com recursos mais robustos e stacks adicionais de tecnologias de front-end. Para aquelas pessoas novas no Laravel, recomendamos aprender o básico com o Laravel Breeze antes de se graduar no Laravel Jetstream.
O Jetstream fornece a geração de código de uma aplicação lindamente projetada para o Laravel e inclui login, registro, verificação de e-mail, autenticação de dois fatores, gerenciamento de sessão, suporte de API via Laravel Sanctum e gerenciamento de equipe opcional. O Jetstream foi projetado usando Tailwind CSS e oferece sua escolha de geração de código front-end orientado pelo Livewire ou Inertia.
A documentação completa para instalação do Laravel Jetstream pode ser encontrada na documentação do Jetstream.