Instalando o Laravel 12

Tempo de leitura: 4 minutos

Instalando o Laravel 12: O Laravel 12 mantém a reputação do framework como a escolha de excelência para o desenvolvimento web em PHP. Para começar a construir aplicações robustas e escaláveis, é necessário configurar o ambiente com o PHP, o Composer (o gerenciador de dependências) e o próprio Laravel.

Este artigo é um guia passo a passo para instalar e configurar o Laravel 12 no seu sistema operacional, garantindo que você tenha um ambiente pronto para codificar.

1. 📋 Pré-requisitos e Ferramentas

Antes de iniciar a instalação do Laravel 12, verifique se você possui as seguintes ferramentas:

Item	Observação
PHP	O Laravel 12 requer, no mínimo, o PHP 8.2 (ou superior).
Composer	Gerenciador de dependências fundamental para o Laravel.
Banco de Dados	MySQL, PostgreSQL, SQLite ou outro (MySQL é usado neste guia).
Editor de Código	Um IDE moderno (VS Code, PhpStorm, Sublime Text, etc.).

2. ⚙️ Instalação Rápida do PHP e Composer

O método mais rápido para instalar o PHP (e, consequentemente, o Composer, que é uma dependência) em ambientes de desenvolvimento é usando ferramentas como Laravel Herd (macOS/Windows) ou instaladores como o php.new.

Recomendação: Se você já usa um ambiente virtualizado como Docker ou Laravel Sail, pule esta seção, pois o PHP e o Composer já estão inclusos.

Se você está instalando localmente sem ambiente virtualizado:

Sistema Operacional	Comando Rápido (para instalar PHP e Composer)
Linux	`/bin/bash -c "$(curl -fsSL https://php.new/install/linux)"`
Windows (PowerShell)	`Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows'))`
macOS	`/bin/bash -c "$(curl -fsSL https://php.new/install/mac)"`

Após a execução, feche e reabra seu terminal para que o sistema reconheça os novos comandos.

2.1. Verificação da Instalação

Confirme se o PHP e o Composer estão prontos:

Bash

php -v
# Esperado: PHP 8.2.x ou superior

composer --version
# Esperado: Composer version 2.x

3. 🆕 Criando seu Primeiro Projeto Laravel 12

O Laravel simplifica a criação de novos projetos através do comando create-project do Composer. A partir do Laravel 11, o instalador global (laravel/installer) é menos utilizado, favorecendo a instalação via Composer, que é mais direta.

A. Comando de Criação

Execute o comando abaixo no terminal para criar um novo projeto (substitua nome-do-projeto pelo nome desejado):

Bash

composer create-project laravel/laravel nome-do-projeto

Atenção: O Laravel 12 utiliza o PHPUnit como framework de testes padrão. A estrutura de middleware e service providers foi simplificada em relação ao Laravel 10/11, com arquivos de configuração mais enxutos.

B. Acessando o Projeto

Entre no novo diretório e abra o projeto no seu editor de código (ex: VS Code):

Bash

cd nome-do-projeto
code .

4. ⚙️ Configuração Inicial e Banco de Dados

A. Configurando o Banco de Dados

O Laravel interage com o banco de dados através do arquivo de variáveis de ambiente .env, localizado na raiz do projeto. Abra este arquivo e ajuste as credenciais.

# .env
DB_CONNECTION=mysql   
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nome_do_seu_banco # <--- Nome do banco de dados que você irá criar
DB_USERNAME=root 
DB_PASSWORD=

Nota: Em ambiente de desenvolvimento local (como no MySQL), o DB_USERNAME é frequentemente root e DB_PASSWORD é vazio, mas certifique-se de que o banco de dados especificado em DB_DATABASE foi criado manualmente no seu servidor MySQL (ex: via phpMyAdmin ou Workbench).

B. Executando as Migrations (Estrutura do BD)

O Laravel exige algumas tabelas básicas para seu próprio funcionamento (como users e migrations). Antes de iniciar o servidor, execute as migrations:

Bash

php artisan migrate:fresh

O comando migrate:fresh remove todas as tabelas (se existirem) e as recria a partir das migration files do projeto.

5. 🖥️ Rodando e Testando a Aplicação

A. Iniciando o Servidor Local

O comando php artisan serve inicia o servidor de desenvolvimento embutido do PHP:

Bash

php artisan serve

Abra seu navegador e acesse http://127.0.0.1:8000. Você deverá ver a página inicial do Laravel 12.

B. O Seu Primeiro “Hello World!”

Para confirmar o funcionamento do sistema de routing e retornar uma resposta simples:

Abra o arquivo routes/web.php.
Substitua a rota padrão que retorna a view welcome:PHP// Original: Route::get('/', function () { return view('welcome'); });
Pelo nosso “Hello World!” direto:PHP// Nova rota: use Illuminate\Support\Facades\Route; Route::get('/', function () { return 'Hello World!'; });

Acesse ou atualize http://127.0.0.1:8000 no seu navegador para ver a mensagem.

✅ Conclusão Instalando o Laravel 12

Instalando o Laravel 12: Você instalou com sucesso o PHP, o Composer e o Laravel 12, configurou o acesso ao banco de dados e rodou a aplicação localmente. O Laravel está pronto para ser a base dos seus próximos projetos. Continue explorando nossa trilha para dominar os conceitos de Routing, Eloquent ORM e Blade no Laravel 12.

Mas antes de dominar o Laravel, se for o seu caso, toda jornada tem um início. Vamos entender quais são os conhecimentos básicos necessários para aproveitar ao máximo este poderoso framework. Para iniciar seus estudos no Laravel, você precisará dominar as seguintes tecnologias: