Skip to content

Latest commit

 

History

History
219 lines (170 loc) · 8.69 KB

kits-para-iniciantes.md

File metadata and controls

219 lines (170 loc) · 8.69 KB
source_url revision status
8332d20b07cc639995649a335620b044151e6dd1
ready

Kits para Iniciantes

Introdução

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!

Laravel Breeze

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.

Imagem da página de registro de nova pessoa usuário do Laravel

Laravel Bootcamp

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.

Instalação {: #instalacao-do-laravel-breeze }

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

Breeze e Blade

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.

Breeze e Livewire

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

Breeze e React / Vue {: #breeze-e-inertia }

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.

Breeze e Next.js / API {: #breeze-e-next }

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.

Implementação de Referência Next.js

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.

Laravel Jetstream

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.