Atualizando o TubePress

O TubePress se atualiza como o WordPress: um clique no painel administrativo busca uma versão assinada, verifica, faz backup, substitui o núcleo e executa as migrações do banco de dados. Seus temas, plugins, mídias e configurações não são alterados.

Esta página explica exatamente o que uma atualização muda, como aplicá-la e como se manter seguro.

Como as atualizações funcionam

As versões são distribuídas como pacotes assinados pelo tubepress.io. Antes de o TubePress tocar em qualquer arquivo, cada pacote é verificado duas vezes:

• um checksum SHA-256 — uma incompatibilidade cancela a atualização; e
• uma assinatura Ed25519 — o núcleo se recusa a instalar sem uma assinatura válida; portanto, um pacote de núcleo adulterado ou sem assinatura é rejeitado imediatamente.

Uma atualização substitui apenas o núcleo fixo. Concretamente:

Imediatamente antes de substituir os arquivos, o TubePress copia o núcleo atual para storage/backups/ e realiza um backup do banco de dados. Se não conseguir criar esse backup, a atualização do núcleo é cancelada para não arriscar seus dados. Os arquivos são então substituídos atomicamente, as novas migrações numeradas em sql/ são executadas automaticamente, e o resultado é registrado em um log de atualização que você pode revisar ou reverter.

Atualização com um clique

Vá para Admin → Atualizações em /admin/updates (acesso de administrador necessário). A tela exibe sua versão atual e todas as atualizações disponíveis para o núcleo, plugins e temas. Verificar atualizações consulta o tubepress.io novamente sob demanda.

Clique para aplicar um item e o TubePress baixa, verifica, faz backup, substitui e migra — e então registra o resultado. Se algo parecer errado depois, você pode reverter para o backup que acabou de ser criado.

Atualizações automáticas

Prefere não se preocupar? Ative a configuração auto_update_enabled (está desativada por padrão). Quando ativada, uma tarefa pseudo-cron em segundo plano verifica periodicamente e aplica atualizações pendentes no máximo uma vez por dia. Por segurança, é deliberadamente conservadora:

• o núcleo e os plugins gratuitos são atualizados automaticamente;
• os temas são sempre deixados para você atualizar manualmente, para que suas personalizações nunca sejam sobrescritas sem supervisão; e
• itens pagos são ignorados — eles precisam de uma compra no marketplace.

O agendador é o mesmo pseudo-cron integrado usado em outros lugares — veja Manutenção.

Atualização manual

O atualizador com um clique é o caminho recomendado porque é o único que também verifica assinaturas, faz backups e executa as migrações do banco de dados. Se o seu painel realmente não consegue alcançar o tubepress.io (um host com firewall ou sem acesso à internet), você pode atualizar manualmente:

1. Faça o backup primeiro. Realize um backup completo de arquivos e banco de dados — veja Backups.
2. Obtenha a versão oficial. Baixe o ZIP assinado na página de download ou na sua conta.
3. Substitua apenas o núcleo. Sobrescreva src/, sql/, templates/admin/, templates/install/ e config/app.php da nova versão. Deixe themes/, plugins/, public/uploads/ e config/database.php no lugar.
4. Aplique as novas migrações. Aplique quaisquer novos arquivos numerados em sql/ ao seu banco de dados — esta é a etapa que o atualizador integrado normalmente faz por você.

O guarda de versão do PHP

O TubePress inclui um pequeno portão de análise segura (config/php-guard.php) que é executado em cada ponto de entrada antes da inicialização do aplicativo. Ele é escrito em PHP deliberadamente antigo para que seja analisado em qualquer versão — o que significa que, se um site for movido para, ou rebaixado para, um PHP mais antigo que o 8.2 necessário, os visitantes verão uma página limpa de “atualização de PHP necessária” em vez de um erro fatal bruto.

Isso é importante nas atualizações: versões mais recentes podem usar sintaxe PHP mais nova; portanto, confirme que seu host executa PHP 8.2 ou mais recente (8.4 recomendado) antes e após atualizar. Mais detalhes em Manutenção.

Antes de atualizar

As atualizações são projetadas para serem seguras e reversíveis, mas um backup ainda é o seu cinto de segurança:

• Faça backup de arquivos e banco de dados — o atualizador cria o seu próprio, mas mantenha também sua própria cópia. Veja Backups.
• Verifique o PHP — confirme que você está no 8.2+ (idealmente 8.4).
• Anote suas personalizações — alterações em temas e plugins são preservadas, mas um inventário rápido nunca é demais.
• Atualize em um horário tranquilo — a substituição é quase instantânea, mas escolha um momento de baixo tráfego por precaução.

Próximos passos