# 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.

> 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.

João Rizzon · 2026-10-26 · Servidores

---

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

```bash
# 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
<?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:

```bash
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.32` e outro em `8.0.39` estã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.x` e outro em `8.0.x` estã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](https://docs.cpanel.net/knowledge-base/general-systems-administration/supported-mysql-mariadb-versions/134/)). 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_ci` convivendo com outras em `utf8mb4_unicode_ci`. Em JOIN entre colunas dessas duas tabelas o erro aparece como `Illegal 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ó:

```sql
SELECT TABLE_NAME, ENGINE, TABLE_COLLATION
FROM information_schema.TABLES
WHERE TABLE_SCHEMA = 'NOME_DO_BANCO';
```

```bash
# 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:

> **** O banco de dados do seu site roda numa versão que o fabricante parou (ou vai parar) de corrigir. Isso significa que falha de segurança descoberta a partir dessa data não ganha correção para essa versão. A atualização é feita pelo painel e é um caminho só de ida: depois de aplicada, não existe botão para voltar. Por isso vou fazer backup completo, testar numa cópia do site antes e combinar com você um horário de baixo movimento para aplicar no site real.

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.

