Master AI

Instalar e configurar o Laravel é o primeiro passo essencial para começar a desenvolver aplicações web com este poderoso framework PHP. Neste capítulo, vamos guiá-lo através da instalação do Laravel numa máquina com Windows, utilizando Wamp ou Xampp com PHP 8.3, Composer e npm. Vamos também mostrar-lhe como testar o servidor de desenvolvimento.

Pré-requisitos

Antes de começar, assegure-se que tem os seguintes componentes instalados no seu computador:

Um servidor para desenvolvimento local como o Xamp ou Wamp (com PHP 8.3)
Composer
Node.js (npm)

Instalar Wamp ou Xampp

Primeiro, escolha entre Wamp ou Xampp para configurar o ambiente de desenvolvimento local. Ambos são pacotes populares que incluem Apache, PHP e MySQL.

Para instalar o Wamp:

Vá ao site oficial do Wamp e descarregue o instalador.
Siga as instruções do assistente de instalação para completar a instalação.

Para instalar o Xampp:

Visite a página de download do Xampp e descarregue o instalador.
Execute o instalador e siga as instruções no ecrã.

Instalar o Composer

O Composer é um gestor de dependências para PHP que facilita a instalação de pacotes e bibliotecas. Para instalar o Composer:

Aceda ao site oficial do Composer e descarregue o instalador.
Execute o instalador e siga as instruções para completar a instalação.

Instalar o Node.js e npm

O Laravel utiliza o npm para gerir os pacotes JavaScript e outras dependências de desenvolvimento. Para instalar o Node.js (que inclui npm):

Visite o site oficial do Node.js e descarregue a versão LTS.
Execute o instalador e siga as instruções no ecrã.

Instalar o Laravel

Com todos os pré-requisitos instalados, pode agora instalar o Laravel utilizando o Composer.

Passos para instalar o Laravel:

Abra o terminal (Command Prompt ou PowerShell no Windows).
Navegue até à pasta onde deseja criar o projeto Laravel. Por exemplo:

cd C:/caminho/para/o/diretorio

Execute o seguinte comando para criar um novo projeto Laravel chamado meu_projeto:

composer create-project --prefer-dist laravel/laravel meu_projeto

O que cada parte do comando faz:

composer: É a ferramenta de gestão de dependências do PHP. Ela é responsável por instalar e manter as bibliotecas e frameworks necessários para o seu projeto.
create-project: Este comando específico do Composer é utilizado para criar um novo projeto a partir de um pacote, como o Laravel.
--prefer-dist: Indica ao Composer para preferir a versão de distribuição (um arquivo compactado) do pacote, o que é geralmente mais rápido.
laravel/laravel: Especifica o pacote Laravel que deseja instalar.
meu_projeto: Define o nome da pasta onde o seu projeto será criado.

Este comando fará o download e a instalação da última versão do Laravel e das suas dependências na pasta meu_projeto.

Versão do Laravel: Para instalar uma versão específica, por exemplo a versão 9.0, use laravel/laravel:^9.0.

Configurar o Laravel

Depois de instalado, é importante configurar corretamente o Laravel para garantir que tudo funciona conforme esperado.

Configurar o `.env`

Navegue até à pasta do seu projeto Laravel:

cd meu_projeto

Abra o ficheiro .env com um editor de texto. Este ficheiro contém variáveis de ambiente que configuram a aplicação Laravel.
Certifique-se de configurar corretamente os detalhes da base de dados e outras variáveis:

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:ChaveGeradaPeloLaravel
APP_DEBUG=true
APP_TIMEZONE=UTC
APP_URL=http://localhost

APP_LOCALE=en
APP_FALLBACK_LOCALE=en
APP_FAKER_LOCALE=en_US

APP_MAINTENANCE_DRIVER=file
# APP_MAINTENANCE_STORE=database

BCRYPT_ROUNDS=12

LOG_CHANNEL=stack
LOG_STACK=single
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug

DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=nome_da_base_de_dados
# DB_USERNAME=seu_utilizador
# DB_PASSWORD=sua_senha

SESSION_DRIVER=database
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_PATH=/
SESSION_DOMAIN=null

Repare que como as sessões são guardadas em base de dados, o driver da base de dados por defeito é o sqlite.

Testar o Servidor de Desenvolvimento

Agora que o Laravel está instalado e configurado, pode testar o servidor de desenvolvimento incorporado.

No terminal, assegure-se de que está na pasta do seu projeto:

cd C:/caminho/para/o/diretorio/meu_projeto

Inicie o servidor de desenvolvimento com o seguinte comando:

php artisan serve

Deverá ver uma saída semelhante a esta:

Starting Laravel development server: http://127.0.0.1:8000

Abra o navegador e vá para http://127.0.0.1:8000. Se tudo estiver configurado corretamente, deverá ver a página de boas-vindas do Laravel.

Resumo

Neste capítulo, instalámos e configurámos o Laravel numa máquina Windows utilizando Wamp ou Xampp, Composer e npm. Além disso, configurámos o ficheiro .env para definir as variáveis de ambiente e testámos o servidor de desenvolvimento para garantir que a instalação foi bem-sucedida.