MySQL no Mautic e no WordPress
Com o Mautic e o WordPress no mesmo servidor, os contatos e as campanhas podem ficar separados dos posts e das configurações do site quando cada app tem um banco e um usuário próprios. O MySQL é o banco relacional que os dois usam para guardar os registros.
Ficha e sumário da página
- Referência técnica
- MySQL 8.4.13 LTS
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Como cada app encontra o banco
Nenhum dos dois apps cria o servidor de banco. Os dois recebem quatro informações e abrem uma conexão comum com elas: o endereço do servidor, o nome do banco, o usuário e a senha. A imagem oficial do WordPress no Docker avisa que o banco informado precisa existir antes da primeira inicialização. O container não o cria. O instalador do Mautic também recebe o nome do banco e um usuário com permissão sobre ele.
Nos containers oficiais, essas informações chegam por variáveis de ambiente, com nomes próprios de cada app:
.env do Mautic e do WordPress, bloco do banco
Mautic, imagem mautic/mautic
MAUTIC_DB_HOST=- O nome do serviço do MySQL na rede interna da stack.
MAUTIC_DB_PORT=- A porta do servidor. O padrão é 3306.
MAUTIC_DB_DATABASE=- O banco que guarda as tabelas do Mautic.
MAUTIC_DB_USER=- O usuário do MySQL criado só para o Mautic.
MAUTIC_DB_PASSWORD=- A senha desse usuário.
WordPress, imagem wordpress
WORDPRESS_DB_HOST=- O nome do serviço do MySQL, com a porta quando não é a 3306.
WORDPRESS_DB_NAME=- O banco do WordPress, que já precisa existir.
WORDPRESS_DB_USER=- O usuário do MySQL criado só para o WordPress.
WORDPRESS_DB_PASSWORD=- A senha desse usuário.
WORDPRESS_TABLE_PREFIX=- O prefixo das tabelas. O padrão é wp_.
Você restringe o acesso de cada app com privilégios concedidos apenas ao banco correspondente, como a página Bancos, usuários e permissões descreve. Com essa configuração, o usuário do Mautic não lê wp_users e o do WordPress não lê leads. Privilégios globais adicionais desfazem essa separação.
O que o WordPress grava
O WordPress cria doze tabelas numa instalação simples, todas com o prefixo wp_ por padrão. A função wp_get_db_schema(), na documentação de desenvolvimento, traz o CREATE TABLE de cada uma. O conteúdo fica em wp_posts, que guarda posts, páginas, anexos, revisões e itens de menu na mesma tabela, separados pela coluna post_type. Os campos extras de cada post vão para wp_postmeta, uma linha por campo. As configurações do site vão para wp_options, com a URL, o tema ativo e as opções de cada plugin.
O padrão de uso é de leitura. Na montagem de uma página, o WordPress consulta o conteúdo e as configurações necessários àquela resposta. O cache pode evitar consultas ao MySQL. As gravações incluem a publicação e a edição de posts, além dos comentários e das alterações feitas por plugins. A wp_postmeta cresce junto com os plugins, porque cada plugin que guarda informação por post acrescenta linhas a ela. As revisões também pesam: quando o WordPress cria uma revisão, ela ocupa uma linha própria em wp_posts. A criação depende das alterações e da configuração de revisões.
A coluna autoload de wp_options merece atenção. As opções marcadas para carga automática são reunidas pelo WordPress durante o carregamento. Um cache de objetos persistente pode fornecer esse conjunto sem nova consulta ao MySQL. Mesmo assim, uma opção grande aumenta o conteúdo carregado quando o conjunto é usado, inclusive por páginas que não precisam daquela opção.
O que o Mautic grava
O Mautic usa o banco como registro de atividade. A tabela leads guarda os contatos, com os campos personalizados virando colunas da própria tabela. Ao redor dela, outras tabelas anotam o que cada contato faz: email_stats recebe uma linha por e-mail enviado, atualizada na abertura. As visitas às páginas com o rastreamento do Mautic vão para page_hits. As mudanças em contatos e campanhas vão para audit_log.
O volume de envios e de atividades rastreadas influencia o crescimento do banco, além da quantidade de contatos e da retenção do histórico. Como exemplo de cálculo, uma base de vinte mil contatos que recebe dois e-mails por semana produz 2,08 milhões de registros de envio em 52 semanas, considerando um registro por destinatário e nenhum descarte. O Mautic também grava em lotes, pelos comandos de console que a imagem oficial roda num container separado, o mautic_cron: a atualização dos segmentos e o avanço das campanhas executam consultas nos horários configurados. O papel mautic_worker consome as filas do Messenger, separado do cron.
A diferença de padrão aparece quando os dois apps dividem o mesmo servidor. O WordPress pode gerar consultas a cada página sem cache. O Mautic também executa consultas em rotinas agendadas, além do rastreamento recebido pela aplicação. Um segmento grande sendo recalculado ocupa o processador e o buffer pool do InnoDB no mesmo minuto das visitas ao site. A página Desempenho: índices e slow log mostra como o MySQL registra as consultas que demoram e de qual banco elas vêm.
Versões em vigor
Os requisitos oficiais do Mautic separam o banco em dois grupos. Para versões anteriores ao Mautic 7, informam MySQL 5.7 ou MariaDB 10.2 como mínimo. Para o Mautic 7 e versões posteriores, informam MySQL 8.4 ou MariaDB 10.11.0. Em 13/11/2026, o repositório oficial marca a versão 7.2.2 como a release mais recente. O suporte a InnoDB aparece como exigência nos dois grupos.
O WordPress é mais tolerante. Os requisitos oficiais do projeto recomendam o MySQL 8.4 ou o MariaDB 10.11, ao lado do PHP 8.3. O mesmo texto registra que o WordPress ainda funciona com o MySQL 5.5.5, uma versão sem suporte há anos. Essa margem existe para hospedagens antigas. Numa VPS própria, a série que atende o Mautic 7 já está dentro da recomendação do WordPress.
Por que o MySQL 8.4 serve aos dois
O MySQL 8.4 LTS é a série que fecha as duas listas: é o mínimo do Mautic 7 e a recomendação do WordPress. A série LTS preserva o conjunto de recursos e recebe correções. Isso reduz mudanças entre releases da mesma série, mas não substitui o teste do Mautic e do WordPress com a versão atualizada. O Percona Server 8.4, usado na stack de referência do Hub, oferece o mesmo servidor para os dois, com os acréscimos descritos na página MySQL e Percona: o que muda.
O conjunto de caracteres também converge. O WordPress usa utf8mb4 nas tabelas desde a versão 4.2. O MySQL 8.4 já cria tabelas novas com utf8mb4 por padrão. As tabelas existentes e a conexão do app também precisam usar o conjunto adequado para receber emojis com caracteres suplementares, como a página InnoDB e tipos de coluna explica.