blog
Servidores

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.

JR · · 8 min de leitura · 1 tabela · 6 blocos de código

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
  1. As três formas de descobrir a versão, e quando usar cada uma
  2. O suporte é anunciado por série, não pelo dígito do patch
  3. Cruzar o número com a doc do painel e o EOL do fornecedor
  4. Escolher o destino pelo que o painel suporta, não pelo que o plugin pede
  5. Cinco verificações antes de clicar, porque a atualização não volta
  6. A frase pronta para explicar a janela ao cliente
  7. 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:

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 é:

  1. Ler na doc do painel quais séries o servidor daquela conta suporta.
  2. Escolher a série suportada mais alta que ainda esteja dentro do calendário de suporte do fornecedor.
  3. 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.

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

  1. Documentação oficial (cpanel) — Supported MySQL and MariaDB Versions. Consultado em 2026-10-08.
Leia também