Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Um projeto novo do Laravel 12 vem com um bloco de conexão MySQL comentado logo abaixo da linha 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

Isso instala o Laravel 12 e suas dependências, gera uma chave de aplicação e cria um banco de dados SQLite padrão para que a aplicação rode imediatamente sem configuração. Confirme a versão:
O Laravel 12 exige PHP 8.2 ou posterior. No macOS sem PHP instalado, 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 para root:

Configurando a Conexão

Abra o .env e troque DB_CONNECTION de sqlite para mysql, e então preencha os detalhes da conexão:
O Laravel se conecta por TCP a 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:
Esse conjunto de modos roda sem alteração no VillageSQL. Não há nenhum flag de modo estrito para desativar ou contornar por compatibilidade.

Executando Migrations

As migrations padrão do Laravel criam as tabelas users, cache e jobs. Execute-as na conexão configurada:
Gere um modelo com a sua própria migration para uma tabela posts:
Adicione as colunas title e body à migration gerada:
Execute-a, e então confirme o formato da tabela diretamente no servidor:

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:
A linha recebeu o próximo valor de auto-incremento, e não 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:
Registre as rotas:
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:
Confirme que as duas linhas foram gravadas consultando o banco de dados diretamente, em vez de confiar apenas nas respostas JSON:

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 que php 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 driver mysql 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