Central de Ajuda

Uma aplicação precisa de três elementos diferentes: banco de dados, usuário e permissões que ligam esse usuário ao banco. Criar apenas o banco ou apenas o usuário não permite a conexão. No cPanel atual, o Database Wizard é o caminho mais seguro para criar os três em sequência.

Dados necessários

• nome curto para o banco e para o usuário;
• senha forte e exclusiva, diferente do cPanel;
• privilégios realmente exigidos pela aplicação;
• host do banco, normalmente localhost para aplicação na mesma hospedagem.

O cPanel normalmente adiciona o usuário da conta como prefixo. Se você digitar loja, o nome final pode ser contacp_loja. Copie o nome completo exibido pelo painel.

Criar pelo Database Wizard

1. Abra cPanel > Databases > Database Wizard. Em versões anteriores, o nome era MySQL Database Wizard.
2. Informe o nome do banco e avance.
3. Crie o usuário com senha gerada e salve a senha em um gerenciador seguro.
4. Selecione os privilégios. Para CMS próprios, ALL PRIVILEGES costuma ser necessário; para integrações, aplique o menor conjunto possível.
5. Conclua e registre banco, usuário, host e charset.

Usar Manage My Databases

Essa interface permite criar itens separadamente, alterar senha e associar usuário a banco. Depois de criar ambos, localize Add User To Database, selecione os nomes completos, clique em Add e marque os privilégios. Sem essa associação, a aplicação normalmente retorna “Access denied”.

Configurar a aplicação

DB_HOST=localhost
DB_DATABASE=contacp_loja
DB_USERNAME=contacp_usuario
DB_PASSWORD=uma-senha-exclusiva

Não publique o arquivo de configuração, não envie a senha em chamado e não use root. Em WordPress, os valores ficam no wp-config.php; em frameworks, geralmente em arquivo de ambiente fora do versionamento.

Importar dados

Crie banco e usuário antes de importar. Para arquivos pequenos, use phpMyAdmin e selecione o banco correto. Para dumps grandes, use SSH ou solicite assistência. Confira charset utf8mb4, versão do MySQL/MariaDB, views, triggers e rotinas.

Acesso remoto

localhost só vale no mesmo servidor. Para conectar externamente, o plano precisa permitir Remote Database Access; autorize somente o IP necessário, use TLS quando disponível e não exponha a porta globalmente. Bancos gerenciados podem exigir hostname e porta próprios.

Erros comuns

• Access denied: usuário/senha errados ou usuário não associado ao banco;
• Unknown database: prefixo omitido ou banco incorreto;
• Connection refused: host, porta, firewall ou serviço;
• Too many connections: conexões não encerradas ou limite atingido;
• acentuação: conexão e tabelas com charsets incompatíveis.

Referência: Database Wizard do cPanel. Para cópias, veja backup e restauração MySQL/MariaDB.

Novos guias relacionados

Aprofunde o diagnóstico com estes conteúdos atualizados:

• phpMyAdmin no cPanel: como acessar, consultar, importar, exportar e reparar bancos MySQL
• cPanel sem espaço: Disk Quota Exceeded, inodes e limite de arquivos — diagnóstico e limpeza

Recursos relacionados

Continue com materiais e serviços relacionados ao tema deste guia.