Qual versão de MySQL a hospedagem usa: 3 formas
Como inventariar a versão de banco de todos os sites que você mantém, cruzar com o calendário oficial de fim de suporte e decidir a migração antes de clicar no botão que não tem volta.

Resposta curta: há três formas de descobrir a versão exata: o bloco "Servidor de banco de dados" do phpMyAdmin, o comando `SELECT VERSION();` via SSH, e um loop com WP-CLI que varre todas as contas da revenda de uma vez. Com o número, cruze com a doc do painel e o calendário do fornecedor.
Neste artigo
- As três formas de descobrir a versão, e quando usar cada uma
- O suporte é anunciado por série, não pelo dígito do patch
- Cruzar o número com a doc do painel e o EOL do fornecedor
- Escolher o destino pelo que o painel suporta, não pelo que o plugin pede
- Cinco verificações antes de clicar, porque a atualização não volta
- A frase pronta para explicar a janela ao cliente
- Transformar o inventário em varredura trimestral
As três formas de descobrir a versão, e quando usar cada uma
Você mantém vinte, cinquenta sites de clientes. Antes de decidir qualquer coisa sobre atualização de banco, precisa de um inventário: qual conta roda o quê. Há três caminhos, e eles servem a situações diferentes.
| Caminho | Precisa de | Serve para | Tempo por site |
|---|---|---|---|
| phpMyAdmin | acesso ao cPanel do cliente | conferir uma conta pontual, sem terminal | ~30 s |
| Terminal / SSH | shell liberado na conta ou no servidor | conferir com precisão e salvar em arquivo | ~10 s |
| Loop em lote na revenda | SSH no servidor da revenda | inventariar todas as contas de uma vez | uma passada |
Um detalhe que confunde muita gente de agência: o número que o WordPress mostra em Ferramentas → Saúde do site é a versão do servidor de banco, não do cliente PHP. Quando o painel informa algo como 10.6.x, é MariaDB. Quando informa 5.7.x ou 8.0.x, é MySQL da Oracle. São projetos diferentes com calendários de suporte diferentes, e essa distinção decide o resto do trabalho.
Ler a versão no bloco Servidor de banco de dados do phpMyAdmin
Entre no cPanel do cliente, abra o phpMyAdmin e olhe o painel direito da tela inicial, bloco Servidor de banco de dados. Ali aparecem o software, a versão completa e o charset do servidor. Anote a linha inteira, não só os dois primeiros dígitos: 10.6.18-MariaDB e 10.6.5-MariaDB são a mesma série, mas só uma delas recebeu as correções do ano.
SELECT VERSION() por SSH, ou um arquivo PHP temporário
Com acesso shell, dois comandos resolvem. O primeiro usa o cliente de linha de comando; o segundo pergunta ao próprio servidor:
# versão do cliente e do servidor
mysql --version
# versão que o servidor realmente reporta
mysql -u USUARIO -p -e "SELECT VERSION();"
Se a conta não tem shell, dá para obter o mesmo valor por PHP, jogando um arquivo temporário no public_html e apagando depois:
<?php
// versao.php - apague depois de usar
$c = new mysqli('localhost', 'USUARIO', 'SENHA', 'BANCO');
echo $c->server_info;
Apague o arquivo assim que ler o número. Deixar credencial de banco em arquivo público é o tipo de descuido que vira incidente três meses depois.
Inventariar todas as contas da revenda com um loop WP-CLI
Na revenda, o inventário manual não escala. O caminho mais simples e previsível é usar o WP-CLI, que lê o wp-config.php de cada conta sozinho:
for d in /home/*/public_html; do
[ -f "$d/wp-config.php" ] || continue
dono=$(stat -c %U "$d")
echo -n "$d: "
sudo -u "$dono" wp db query "SELECT VERSION();" \
--path="$d" --skip-column-names 2>/dev/null || echo "falhou"
done
O sudo -u existe por um motivo prático: varrendo /home você está como root, e o WP-CLI recusa rodar como root sem --allow-root. Sem o sudo, toda linha cairia no || e você leria uma planilha inteira de falso negativo. A alternativa é acrescentar --allow-root, com a ressalva de que qualquer arquivo que o WP-CLI gerar (cache, log) fica com dono root dentro da conta do cliente, e isso quebra o site depois.
Saída esperada, uma linha por conta:
/home/cliente01/public_html: 10.6.18-MariaDB
/home/cliente02/public_html: 8.0.39
/home/cliente03/public_html: falhou
Linha com falhou é para conferir na mão: costuma ser banco com credencial errada no wp-config.php ou conta suspensa.
Rode com tee inventario.txt no final para guardar o resultado. É esse arquivo que vira a planilha de decisão da agência. Se o servidor da revenda não tem WP-CLI instalado, faça a mesma varredura entrando conta a conta pelo phpMyAdmin e preenchendo a planilha na mão: é chato, mas é uma vez por ciclo, não toda semana.
O suporte é anunciado por série, não pelo dígito do patch
Versões de MySQL e MariaDB têm três partes: série maior, série menor e patch. O suporte é anunciado por série (5.7, 8.0, 10.6, 11.4), e as correções chegam como novos patches dentro da série. Duas consequências práticas:
- Um site em
8.0.32e outro em8.0.39estão na mesma situação de suporte. A diferença é o quanto o servidor está atrasado nos patches, o que é responsabilidade do provedor, não sua. - Um site em
5.7.xe outro em8.0.xestão em situações completamente diferentes, mesmo que ambos respondam a tudo que o plugin pede hoje.
MariaDB não é "a mesma coisa com outro nome". A numeração correu por fora depois do fork, e por isso uma série 10.x de MariaDB pode ser mais recente que a 8.0 do MySQL. Comparar os números entre os dois projetos não diz nada.
Cruzar o número com a doc do painel e o EOL do fornecedor
Com o número em mãos, a pergunta do cliente é sempre a mesma: ainda recebe correção. Para responder, use duas fontes, nessa ordem.
Primeiro, a documentação do painel. O cPanel publica a lista de versões de MySQL e MariaDB que a versão instalada do painel suporta, e marca as que deixaram de ser suportadas (Supported MySQL and MariaDB Versions, docs.cpanel.net). Essa página é o limite real do que você consegue fazer: se a série para onde você quer ir não aparece ali como suportada no servidor em questão, o botão simplesmente não vai existir.
Segundo, o calendário do fornecedor do banco. Abra a página de ciclo de vida do próprio fornecedor: MySQL no site da Oracle, MariaDB no site da MariaDB Foundation. Essas datas não foram verificadas aqui, e a única fonte consultada neste texto é a doc do cPanel citada acima. Consulte a data na fonte do fornecedor no dia em que for montar o plano e registre a data junto do inventário. Não repasse de cabeça nem copie de blog: data de EOL muda quando o fornecedor estende ou antecipa, e quem assina o plano de migração é você.
Na planilha, três colunas resolvem a decisão: versão atual, status na doc do painel, data de EOL do fornecedor. Se a terceira coluna já passou, o site está rodando sem correção de segurança publicada, e isso vira prioridade independente do que o cliente acha do assunto.
Escolher o destino pelo que o painel suporta, não pelo que o plugin pede
O erro mais caro aqui é escolher o destino pela mensagem do plugin. Um plugin que pede "MySQL 8.0 ou superior" está descrevendo o que ele testou, não o que o seu servidor tem. A sequência correta é:
- Ler na doc do painel quais séries o servidor daquela conta suporta.
- Escolher a série suportada mais alta que ainda esteja dentro do calendário de suporte do fornecedor.
- Só então conferir se os plugins e o core do WordPress do site declaram compatibilidade com essa série.
Se o passo 1 e o passo 3 não se encontram, o problema não é de banco: é de hospedagem ou de plugin, e a conversa muda de assunto.
Cinco verificações antes de clicar, porque a atualização não volta
Atualização de versão de banco em hospedagem compartilhada costuma ser sem volta. O painel atualiza para frente; ele não desfaz. Por isso, estes cinco itens antes de qualquer ação.
- Dump completo e verificado. Gere o backup e confira que ele abre, não só que o arquivo existe.
- Collation de cada tabela. Bancos antigos carregam tabelas em
utf8mb3_general_ciconvivendo com outras emutf8mb4_unicode_ci. Em JOIN entre colunas dessas duas tabelas o erro aparece comoIllegal mix of collations, às vezes só depois da migração. - Mecanismo de armazenamento. Tabela em MyISAM é herança de instalação antiga e se comporta diferente em versões novas. Liste antes.
- Clone de teste. Suba uma cópia do site em subdomínio ou local, com a versão de destino, e rode o fluxo crítico do cliente (checkout, formulário, área logada).
- Janela combinada por escrito. Com data, horário e quem valida depois.
Os dois primeiros itens saem de uma consulta só:
SELECT TABLE_NAME, ENGINE, TABLE_COLLATION
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'NOME_DO_BANCO';
# dump e conferência rápida do arquivo gerado
mysqldump -u USUARIO -p BANCO > backup.sql
tail -n 3 backup.sql # deve terminar em "Dump completed"
A frase pronta para explicar a janela ao cliente
O cliente não quer saber de série nem de collation. Ele quer saber por que você está pedindo uma janela e por que não dá para testar "ao vivo". Use algo assim, adaptando o nome da versão:
Três coisas essa frase faz: nomeia o risco sem dramatizar, explica por que o processo tem custo de hora, e transfere a decisão de horário para o cliente, que é quem conhece o movimento do negócio.
Transformar o inventário em varredura trimestral
Transforme o arquivo em rotina. Uma varredura por trimestre, com as colunas de versão, status no painel e EOL do fornecedor, já dá o suficiente para você abrir chamado com antecedência em vez de apagar incêndio. Sites parados em série fora de suporte sobem para o topo da fila; sites em série suportada ficam marcados com a data em que a série deixa de receber correção.
E vale dizer o que não resolve: se o site está lento, mudar de série de banco raramente é a causa e raramente é a cura. Antes de propor migração como solução de performance, olhe o log de consulta lenta e as consultas da própria instalação. Migração de versão é assunto de ciclo de vida e segurança. Confundir os dois leva a entregar uma janela de risco para o cliente e não melhorar nada no tempo de resposta.
Com o inventário fechado e o checklist cumprido, o passo seguinte é o procedimento de execução: atualizar a versão pelo painel, com o clone validado e o dump na mão.
Referências
- Documentação oficial (cpanel) — Supported MySQL and MariaDB Versions. Consultado em 2026-10-08.