GUIA DE INSTALAÇÃO

Laravel Da instalação ao primeiro projeto.

Um guia prático da Agência A7 Sites para preparar o ambiente, instalar o Laravel, configurar banco de dados, Vite, Bootstrap ou Tailwind CSS, Font Awesome e iniciar o desenvolvimento.

GUIA ATUALIZADO PARA Laravel 13.x

Terminal

$ php -v

PHP instalado

$ composer --version

Composer instalado

$ node -v

Node.js instalado

$ laravel new meu-projeto

✓ Projeto pronto

01 Pré-requisitos 02 Composer 03 Node.js 04 Laravel 05 Ambiente 06 Banco 07 Frontend 08 Font Awesome 09 Produção

01 / PRÉ-REQUISITOS

Antes de instalar o Laravel.

Prepare primeiro o ambiente de desenvolvimento. Isso evita a maioria dos erros encontrados durante a criação de um novo projeto.

PHP

O Laravel necessita do PHP e das extensões exigidas pelo framework.

php -v

Composer

Responsável pelas dependências PHP utilizadas pelo Laravel.

composer --version

Node.js + NPM

Utilizados pelo Vite para processar CSS, JavaScript e bibliotecas frontend.

node -v && npm -v

Banco de dados

MySQL, MariaDB, PostgreSQL, SQLite ou outro banco compatível com sua aplicação.

02 / COMPOSER

Gerenciando as dependências PHP.

Composer é utilizado pelo Laravel para instalar e atualizar bibliotecas PHP.

Verifique primeiro se o Composer está instalado.

Abra o terminal e execute:

Terminal

composer --version

Caso o comando não seja reconhecido, instale o Composer antes de continuar.

Observação

Depois de instalar o Composer no Windows, feche e abra novamente o terminal para que as variáveis de ambiente sejam atualizadas.

COMPOSER

Dependências PHP

O arquivo composer.json descreve as dependências do projeto.

O arquivo composer.lock registra exatamente as versões instaladas.

Em projetos existentes use:

composer install

03 / NODE.JS

Preparando o frontend.

Laravel utiliza Vite para processar os assets frontend. Para isso precisamos do Node.js e NPM.

RECOMENDADO

Utilize uma versão LTS do Node.js.

Para projetos profissionais, dê preferência às versões LTS em vez das versões Current.

Verifique Node e NPM

Terminal

node -v
npm -v

Atualmente o site oficial do Node disponibiliza uma linha LTS, que é a escolha recomendada para projetos Laravel de produção.

Não instale dependências frontend globalmente sem necessidade.

Bootstrap, Tailwind, Font Awesome e demais pacotes devem ficar normalmente registrados no package.json do projeto.

04 / INSTALAÇÃO

Criando seu projeto Laravel.

Instale o Laravel Installer

Terminal

composer global require laravel/installer

Crie o projeto

Terminal

laravel new meu-projeto

Entre na pasta

Terminal

cd meu-projeto

Instale os assets

Terminal

npm install
npm run build

INICIAR AMBIENTE DE DESENVOLVIMENTO


                    composer run dev

O script de desenvolvimento pode iniciar os serviços necessários para trabalhar localmente com Laravel.

05 / AMBIENTE

Configurando o projeto.

Arquivo `.env`

As configurações específicas do ambiente ficam no arquivo .env.

.env

APP_NAME="Meu Projeto"
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=meu_projeto
DB_USERNAME=root
DB_PASSWORD=

Configuração inicial

Nome da aplicação
Ambiente local
URL
Banco de dados
Credenciais locais

Nunca publique seu `.env`.

Esse arquivo pode conter senhas, tokens e outras configurações sensíveis.

06 / BANCO DE DADOS

Preparando as migrations.

Terminal

php artisan migrate

Criar migration


                        php artisan make:migration create_posts_table

Status


                        php artisan migrate:status

Rollback


                        php artisan migrate:rollback

07 / FRONTEND

Escolha Bootstrap ou Tailwind CSS.

Você não precisa instalar os dois. Escolha a abordagem mais adequada ao projeto.

OPÇÃO 01

Bootstrap

Excelente para desenvolvimento rápido com componentes prontos e grid responsivo.

Terminal

npm install bootstrap @popperjs/core

`resources/js/app.js`

import 'bootstrap';
import 'bootstrap/dist/css/bootstrap.min.css';

OPÇÃO 02

Tailwind CSS

Ideal para interfaces altamente personalizadas utilizando classes utilitárias.

Terminal

npm install tailwindcss @tailwindcss/vite

`resources/css/app.css`

@import "tailwindcss";

Vite

Laravel utiliza Vite para processar CSS e JavaScript.


                    npm run dev

08 / FONT AWESOME

Instalando Font Awesome Free.

Para utilizar o pacote gratuito completo:

Terminal

npm install --save @fortawesome/fontawesome-free

Importe no `resources/js/app.js`

import '@fortawesome/fontawesome-free/css/all.min.css';

Exemplo Blade

<i class="fa-solid fa-house"></i>

<i class="fa-solid fa-user"></i>

<i class="fa-brands fa-laravel"></i>

09 / PRODUÇÃO

Antes de colocar no servidor.

composer install --no-dev --optimize-autoloader

npm install
npm run build

php artisan migrate --force

php artisan optimize

`APP_ENV=production`
`APP_DEBUG=false`
Configurar `.env`
Executar migrations
Compilar assets
Apontar domínio para `public/`

REFERÊNCIA RÁPIDA

Comandos que você vai usar muito.

Servidor php artisan serve

Rotas php artisan route:list

Controller php artisan make:controller NomeController

Model php artisan make:model Nome

Model + Migration php artisan make:model Nome -m

Limpar caches php artisan optimize:clear

Vite npm run dev

Build produção npm run build