Como testar a conexão com o banco de dados MySQL (guia passo a passo completo)
Objetivo: Ajudar você a confirmar se o MySQL está acessível, se as credenciais estão corretas e onde está a falha (rede, firewall, serviço, porta, SSL/TLS, permissões ou código).
Para testar a conexão do seu site com uma base de dados "MySQL" via código PHP, utilize o procedimento abaixo:
1 - Copie e cole o codigo abaixo em um bloco de notas ou bloco do notepad++ e salve como mysqltest.php.
2 - Transfira o arquivo para sua hospedagem dentro da pasta public_html.
<?php
$host = "HOST_DO_MYSQL"; // ex: localhost ou mysql.seudominio.com
$user = "USUARIO";
$pass = "SENHA";
$db = "NOME_DO_BANCO"; // opcional
$conn = @mysqli_connect($host, $user, $pass, $db);
if (!$conn) {
die("❌ Erro de conexão: " . mysqli_connect_error());
}
echo "✅ Conexão com MySQL bem-sucedida!<br>";
$result = mysqli_query($conn, "SELECT NOW() AS agora, VERSION() AS versao");
$row = mysqli_fetch_assoc($result);
echo "Hora do servidor: " . $row['agora'] . "<br>";
echo "Versão do MySQL: " . $row['versao'];
mysqli_close($conn);
?>
Mas atenção. No código acima você deve alterar as seguintes variáveis:
HOST_DO_MYSQL = Endereço do servidor do banco de dados. Geralmente utilizamos "localhost".
USUARIO = Nome do usuário criado para acesso ao banco de dados.
SENHA = Senha do usuario que você criou para o banco de dados.
NOME_DO_BANCO = Nome do banco de dados que você criou.
3 - Abra o navegador para acessar o arquivo que você enviou vis FTP atraves do endereço: http://seudominio.com.br/mysqltest.php
4 - Se funcionar, aparecerá uma mensagem de sucesso com a hora e versão do MySQL.
5 - Lembre-se de apagar o arquivo posteriormente para não expor suas credenciais.
Conclusão
Testar a conexão com o banco de dados MySQL é um passo essencial para garantir que sua aplicação funcione corretamente e sem surpresas. Com este simples script PHP enviando via FTP, é possível validar rapidamente se as credenciais, o servidor e a porta estão configurados de forma correta.
Esse tipo de teste ajuda a identificar se o problema está na aplicação, no servidor ou nas permissões do banco, evitando perda de tempo em diagnósticos mais complexos. Após confirmar a conexão, lembre-se sempre de remover o arquivo de teste para manter a segurança do seu ambiente.
-------------------------------------------------
Gostou da nossa dica ? Ajude a mantermos este artigo no ar e criar mais conteúdos de ajuda.
Contribua com qualquer valor para o pix abaixo:
Nosso pix: chave CNPJ: 10.284.773/0001-09
