VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
DB_CONNECTION ativa no .env, usando o mesmo formato de host, porta, banco de dados, usuário e senha que todo cliente MySQL espera. Descomentá-lo e preencher os valores reais é toda a integração. Este guia percorre essa configuração de ponta a ponta: conectar, executar uma migration, e ler e gravar pelo Eloquent.
Criando o Projeto
brew install php composer instala ambos; a build do PHP 8.5 do Homebrew inclui pdo_mysql e mysqli por padrão, então nenhuma configuração extra de extensão é necessária para o MySQL.
Criando o Banco de Dados e o Usuário
Crie um banco de dados dedicado e um usuário com escopo restrito em vez de apontar a aplicação pararoot:
Configurando a Conexão
Abra o.env e troque DB_CONNECTION de sqlite para mysql, e então preencha os detalhes da conexão:
127.0.0.1 aqui, o mesmo host que a instrução CREATE USER acima autorizou. O VillageSQL é um substituto direto para o MySQL, então nada muda em config/database.php nem nas chaves do .env.
config/database.php define 'strict' => true na conexão mysql por padrão. Isso coloca a sessão no modo SQL estrito padrão do MySQL:
Executando Migrations
As migrations padrão do Laravel criam as tabelasusers, cache e jobs. Execute-as na conexão configurada:
posts:
title e body à migration gerada:
Eloquent e Proteção contra Atribuição em Massa
Os modelos Eloquent do Laravel bloqueiam a atribuição em massa por padrão, a menos que um campo esteja listado em$fillable:
id, created_at e updated_at ficam de fora de propósito. Passar um id para create() não gera erro e não sobrescreve o valor; o Eloquent descarta silenciosamente qualquer chave que não esteja em $fillable:
999. Isso importa quando um método store() aceita o corpo de uma requisição diretamente: sem o $fillable delimitando as colunas, um cliente poderia passar id ou um campo de timestamp e tê-lo aceito sem questionamento. $fillable protege o modelo; a validação da requisição é uma preocupação separada, que verifica o formato dos dados recebidos.
Rotas e um Controller
O esqueleto padrão do Laravel 12 mantém o roteamento mínimo:routes/web.php contém as rotas, e bootstrap/app.php configura o middleware e o tratamento de exceções sem o antigo arquivo Http/Kernel.php. Gere um controller:
routes/web.php roda atrás do middleware de CSRF baseado em sessão do Laravel, que rejeita um curl -X POST simples com 419 Page Expired porque a requisição não carrega um token CSRF. Isso é esperado para uma rota de formulário voltada ao navegador; um formulário real envia o token por um campo oculto. Para uma rota feita para ser chamada diretamente, sem formulário nem token, exclua-a em bootstrap/app.php:
Verificando de Ponta a Ponta
Inicie o servidor embutido e exercite as duas rotas. A tabela já tem a linha da demonstração do$fillable acima, então a rota de índice a retorna:
Perguntas Frequentes
Por que o Laravel usa SQLite por padrão em vez do MySQL?
As versões recentes do Laravel criam os projetos novos com SQLite por padrão para quephp artisan serve funcione imediatamente sem nenhuma configuração. O arquivo .env ainda carrega as chaves de conexão do MySQL logo abaixo da linha DB_CONNECTION ativa, comentadas. Mudar para o MySQL é uma questão de descomentar e preencher cinco valores, e não uma nova seção de configuração.
O Eloquent precisa de alguma configuração especial para funcionar com o VillageSQL?
Não. O VillageSQL é um substituto direto para o MySQL e fala o mesmo protocolo de rede, então o drivermysql do Laravel, sua configuração de modo SQL estrito e sua gramática de consultas funcionam sem alteração.
Qual é a diferença entre $fillable e a validação da requisição?
$request->validate() decide quais campos são aceitos da requisição recebida e rejeita entradas malformadas com uma resposta 422. $fillable no modelo decide quais dos campos que você passa para create() ou fill() são de fato gravados no banco de dados. Usar $request->validate() sozinho ainda deixa o modelo aberto à atribuição em massa se um controller em outro lugar chamar Post::create($request->all()); $fillable protege o modelo independentemente de qual controller o chama.
Solução de Problemas
Veja também
- Usando MySQL com ORMs: Django, Rails e Prisma — as mesmas configurações no nível da conexão e os padrões N+1 de um ângulo independente de ORM
- Migrações de Esquema no MySQL — o que os arquivos de migration do Laravel fazem com a tabela por baixo do
ALTER TABLE - Pool de Conexões no MySQL — configurando conexões persistentes para uma aplicação Laravel sob tráfego real