Para configurar o acesso à base de dados na vossa aplicação Laravel, é essencial definir as credenciais de ligação no ficheiro .env. Este ficheiro está localizado no diretório raiz da vossa aplicação e contém todas as configurações sensíveis da aplicação, como as credenciais de acesso à base de dados, chaves de API, entre outras.

Passo 1: Verificar a Instalação do Laravel

Antes de começar, assegurem-se de que têm uma instalação Laravel funcional. Se não tiverem ainda instalado o Laravel, podem seguir os passos no capítulo anterior para instalá-lo.

Passo 2: Configuração do Ambiente

No vosso ficheiro .env, irão encontrar várias variáveis que definem as configurações do ambiente. A secção relevante para a base de dados é geralmente semelhante a esta:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nome_da_base_de_dados
DB_USERNAME=nome_de_utilizador
DB_PASSWORD=senha

Passo 3: Atualizar as Credenciais

Atualizem estes campos com as informações da vossa base de dados:

• DB_CONNECTION: o tipo de base de dados (por defeito no Laravel 11, é sqlite, mas pode ser pgsql, mysql, entre outros).
• DB_HOST: o endereço da base de dados (usualmente 127.0.0.1 ou localhost se a base de dados estiver no servidor local).
• DB_PORT: a porta de ligação à base de dados (o padrão para MySQL é 3306).
• DB_DATABASE: o nome da base de dados que criaram para a vossa aplicação.
• DB_USERNAME: o nome de utilizador com permissões de acesso à base de dados.
• DB_PASSWORD: a senha do utilizador da base de dados.

Exemplo Prático

Suponhamos que temos um MySQL local com as seguintes credenciais:

• Base de dados: laravel_app
• Utilizador: root
• Senha: password123

O ficheiro .env deve ficar assim:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_app
DB_USERNAME=root
DB_PASSWORD=password123

Passo 4: Testar a Ligação à Base de Dados

Após atualizar o .env, podem testar se a aplicação consegue ligar-se à base de dados. Para isso, executem a seguinte migração para criar uma tabela de testes: Nota: ao instalar o Laravel 11 já foi executada uma migração inicial por causa das sessões.

php artisan migrate

Se a migração for bem-sucedida, significa que a ligação à base de dados foi configurada corretamente.

Problemas Comuns e Soluções

• Erro de autenticação: Verifiquem se o nome de utilizador e a senha no ficheiro .env estão corretos.
• Base de dados não encontrada: Certifiquem-se de que a base de dados existe e que o nome fornecido em DB_DATABASE está correto.
• Erro de ligação: Confiram se DB_HOST e DB_PORT estão corretos e se o serviço da base de dados está a correr.

Sumário

Neste capítulo, aprenderam a configurar a ligação da vossa aplicação Laravel à base de dados atualizando o ficheiro .env. Esta configuração é fundamental para que a aplicação possa interagir com a base de dados, permitindo operações CRUD (Create, Read, Update, Delete).