Backup é uma cópia do site inteiro congelada num momento e guardada fora do servidor: os arquivos, uma cópia completa do banco (um dump, o banco escrito num arquivo só) e os uploads, compactados e baixados para o seu computador. É o seu caminho de volta quando algo dá errado, e o kit para mudar o site de hospedagem.
Não é a cópia local em que você trabalha (veja Sites de clientes). Essa cópia é atualizada e deixa de fora dados pessoais e segredos. O backup tem tudo; você guarda e não mexe.
Peça à IA
Faz um backup completo do site da Escola Aquarela que está no ar: arquivos, banco e uploads. Baixa para ~/Backups/aquarela, me diz o tamanho e depois apaga a cópia temporária do servidor.
A IA usa a conexão SSH salva no projeto (o acesso seguro ao servidor): monta o arquivo no servidor e baixa esse arquivo único.
O que vem no arquivo
| Parte | Por que importa |
|---|---|
| O dump do banco | Tudo o que está no banco: posts, páginas, termos, registros de mídia, configurações, usuários do painel e, quando o site tem, envios de formulário, membros e pedidos. É o conteúdo. |
storage/ | Os arquivos de mídia (storage/uploads/) e os anexos dos envios de formulário. Sem os uploads, toda imagem quebra depois de restaurar. O cache fica de fora: ele se refaz sozinho. |
theme/ | A estrutura (site.json), os templates e o visual. |
.env, .htaccess, robots.txt, .velk-version | As configurações e o marcador de versão. O .env guarda a senha do banco e as chaves do site. |
| O motor | Vem junto, embora seja a única parte que daria para baixar de novo em releases.velkcms.com. |
.env do site. Para um site no seu computador, a IA roda o mesmo dump e o mesmo zip na pasta do projeto.Hospedagem sem SSH
Sem SSH, a IA não consegue montar o arquivo no servidor, então os cliques são seus: exporte o banco no phpMyAdmin (a ferramenta de banco que quase todo painel de hospedagem tem), em formato SQL, e baixe por FTP pelo menos theme/, storage/uploads/ e .env. A IA te guia passo a passo.
Quando fazer
-
Antes de atualizar o Velk
A atualização troca o motor e ajusta o banco, e não faz backup de nada sozinha.
-
Antes de uma mudança grande de estrutura
Tipos de conteúdo novos, campos renomeados, uma home nova.
-
Antes de mexer direto no servidor
Lá, todo erro acontece no site no ar.
-
Antes de mudar de hospedagem
O backup é o kit da mudança.
-
De tempos em tempos, sem motivo
Assim o último backup é sempre recente.
Restaurar
-
Ponha os arquivos numa hospedagem
Qualquer uma com PHP 8.2 ou mais novo e MySQL. Descompacte o arquivo na pasta do site.
-
Importe o banco
Crie um banco e importe o dump nele.
-
Aponte o
.envpara elePreencha os dados do banco novo e ajuste o
APP_URL, o endereço do site, para onde ele mora agora. -
Abra o site
As migrações (os passos que ajustam o banco a cada versão) já estão aplicadas no dump, então não há nada para rodar de novo.
Peça à IA
Restaura o backup velk-backup-20261024.zip aqui no meu computador, num banco novo chamado aquarela_restore, para eu conferir que funciona. Antes de eu abrir, desliga os scripts de rastreamento e tira os destinatários dos formulários nessa cópia.
Um backup restaurado é uma cópia completa da produção: diferente da cópia local, ele vem com os destinatários dos formulários e os scripts de rastreamento do cliente.
Bom saber
- Arquivos e banco do mesmo momento. Um banco de hoje com um
site.jsonmais antigo pode apontar para campos que a estrutura não declara mais. Faça o backup dos dois juntos. - Só os arquivos não trazem o site de volta. O conteúdo mora no banco, e os arquivos de um site instalado em cima de um banco vazio não o reconstroem.
- Uma biblioteca de mídia grande deixa todo backup grande. Peça para fazer o backup de
storage/uploads/separado. - Para automatizar, peça à IA um cron (uma tarefa que o servidor roda num horário marcado) que gere o dump, compacte e apague os backups antigos. Baixe um de vez em quando: backup que só existe no servidor cai junto com ele.
- “command not found” durante um backup quer dizer que a hospedagem guarda o
mysqldumpnum lugar diferente. O suporte da hospedagem sabe onde.