# Como corrigir o erro de backup incremental no UpdraftPlus

O erro de backup incremental no UpdraftPlus ocorre quando falta um backup completo de base, quando o recurso Premium não esta ativo ou quando o agendador do WordPress interrompe o processo, fazendo o incremental não rodar ou parar no meio.

## O que é erro de backup incremental no UpdraftPlus?

O backup incremental do UpdraftPlus salva apenas os arquivos que mudaram desde o último backup completo, em vez de recriar o site inteiro a cada execução. Segundo a documentação oficial, esse recurso depende de uma base: você precisa primeiro criar um backup completo, e so depois o UpdraftPlus passa a registrar apenas as alterações por cima dela. Na hora de restaurar, o plugin combina o backup completo com as camadas incrementais.

O erro de backup incremental no UpdraftPlus aparece quando essa cadeia quebra. Os sintomas mais comuns são o link 'Add changed files (incremental backup)' não aparecer, o incremental não executar mesmo agendado, ou o processo iniciar e parar no meio sem concluir. As causas raiz são três: o recurso e exclusivo da versão Premium e não funciona no UpdraftPlus gratuito, não existe um backup completo de base valido, ou o agendador do WordPress (WP-Cron e conexoes de loopback) e interrompido pelo servidor antes do job terminar.

## Como identificar

- O link 'Add changed files (incremental backup)...' não aparece na aba de backups, mesmo após clicar em 'Backup Now'.
- O agendamento incremental esta configurado em 'Files backup schedule', mas nenhum backup incremental novo surge em 'Existing backups'.
- O backup incremental inicia, mostra progresso e para no meio sem nunca chegar a 100 por cento.
- O log do UpdraftPlus registra a entrada inicial mas não avanca além da etapa 0, indicando que o job não foi retomado.
- A mensagem 'The backup has not finished; a resumption is scheduled' aparece e o backup permanece travado indefinidamente.

**Antes de começar:** Antes de editar o wp-config.php ou alterar limites de PHP em producao, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para conseguir reverter caso o site fique inacessivel após a mudanca.

## Como prevenir

- Sempre mantenha pelo menos um backup completo recente como base antes de depender de backups incrementais, pois o incremental não se restaura sozinho sem o backup completo correspondente.
- Use um cron externo do servidor em vez de confiar apenas no WP-Cron, que so dispara quando ha visitas e e a causa número um de backups que param no meio.
- Garanta que as conexoes de loopback do host estejam liberadas e sem proteção de senha por .htaccess, para o UpdraftPlus conseguir retomar jobs longos.
- Monitore os limites de PHP do plano (memória e tempo de execução) e ajuste-os com folga antes de agendar incrementais frequentes em sites grandes.

Erros relacionados

- [Como corrigir o backup automático que não roda no UpdraftPlus](https://full.services/wp-fixer/corrigir-backup-automatico-updraftplus/)
- [Como corrigir o agendamento de backups que não funciona no UpdraftPlus](https://full.services/wp-fixer/corrigir-agendamento-backup-updraftplus/)
- [Como corrigir o backup de banco de dados grande que falha no UpdraftPlus](https://full.services/wp-fixer/corrigir-backup-banco-grande-updraftplus/)

## Causa

- O site usa o UpdraftPlus gratuito: o backup incremental e exclusivo do UpdraftPlus Premium, entao o link 'Add changed files (incremental backup)' simplesmente não existe na versão gratuita.
- Não ha um backup completo de base valido antes do incremental: a documentação oficial exige criar um backup completo primeiro, pois o incremental so registra os arquivos alterados por cima dessa base.
- O WP-Cron esta desligado por 'DISABLE_WP_CRON' definido como true no wp-config.php, entao o agendador do WordPress não dispara a retomada do job incremental e ele para no meio.
- As conexoes de loopback do servidor estão bloqueadas pelo host (ou por proteção de senha via .htaccess), impedindo que o UpdraftPlus reabra o próprio processo para continuar o backup interrompido.
- O limite de PHP (max_execution_time ou memory_limit) e atingido durante a coleta dos arquivos alterados, fazendo o servidor encerrar o processo antes de o incremental concluir.

## Como resolver

1. Confirme o UpdraftPlus Premium e crie um backup completo de base: O backup incremental e um recurso Premium e exige um backup completo previo. Confirme que a versão Premium esta ativa e rode um backup completo antes de tentar o incremental, pois sem essa base o link de incremental não aparece.

```
Painel WP -> Configurações -> UpdraftPlus Backups
Clique em 'Backup Now' e conclua um backup completo de arquivos e banco
Depois, use o link 'Add changed files (incremental backup)...' que passa a aparecer
```

2. Verifique o agendador do WordPress (WP-Cron): A doc oficial aponta o agendador do WordPress como causa número um de backups que param no meio. Confira se 'DISABLE_WP_CRON' não esta forcando o cron desligado no wp-config.php e se o site não esta em modo de manutenção.

```
Abra o wp-config.php via FTP ou gerenciador de arquivos
Localize a linha define( 'DISABLE_WP_CRON', true );
Remova essa linha ou troque o valor para false e salve o arquivo
```

3. Habilite o cron alternativo se o loopback estiver bloqueado: Quando o host bloqueia conexoes de loopback, o UpdraftPlus não consegue reabrir o próprio processo para retomar o backup. A doc recomenda ativar o ALTERNATE_WP_CRON nesse cenario para o agendamento voltar a funcionar.

```
Abra o wp-config.php via FTP
```

4. Acima da linha /* That's all, stop editing! */ adicione:

```
define( 'ALTERNATE_WP_CRON', true );
```

5. Aumente os limites de PHP que cortam o backup: Se o incremental para sempre na mesma etapa, o servidor pode estar atingindo o tempo ou a memória de PHP durante a varredura dos arquivos. Eleve max_execution_time e memory_limit, ou peca ao seu provedor de hospedagem que faça isso.

```
No wp-config.php adicione: @ini_set( 'memory_limit', '256M' );
No php.ini ajuste: max_execution_time = 300
Defina também no wp-config.php: define( 'WP_MEMORY_LIMIT', '256M' );
```

6. Configure um cron externo para garantir a retomada: Em hosts que matam processos longos, um cron externo do servidor dispara o wp-cron.php de forma confiavel e garante que o UpdraftPlus retome o backup incremental até concluir. Use o acesso ao cron do painel da hospedagem.

```
No painel da hospedagem, crie um Cron Job a cada 5 minutos
Aponte o comando para: wp-cron.php do seu site
Comando: wget -q -O - https://seusite.com/wp-cron.php?doing_wp_cron
```


## Código

```php
// No wp-config.php, antes de /* That's all, stop editing! */

// 1. Garante que o WP-Cron interno nao foi desligado.
if ( ! defined( 'DISABLE_WP_CRON' ) ) {
    define( 'DISABLE_WP_CRON', false );
}

// 2. Usa o cron alternativo quando o loopback do host esta bloqueado,
//    permitindo que o UpdraftPlus retome o backup incremental.
define( 'ALTERNATE_WP_CRON', true );

// 3. Eleva memoria e tempo para a varredura dos arquivos alterados
//    nao ser cortada pelo servidor no meio do job.
define( 'WP_MEMORY_LIMIT', '256M' );
@ini_set( 'max_execution_time', '300' );
```

## Perguntas frequentes

### Por que o backup incremental não aparece no meu UpdraftPlus

O backup incremental e um recurso exclusivo do UpdraftPlus Premium. Na versão gratuita o link 'Add changed files (incremental backup)' não existe. Confirme que a versão Premium esta instalada e ativa para a opção surgir.

### Preciso de um backup completo antes de fazer o incremental

Sim. A documentação oficial exige um backup completo de base antes do incremental, porque o incremental registra apenas os arquivos que mudaram por cima dessa base. Sem o backup completo valido, o incremental não tem do que partir.

### Por que o backup incremental para no meio e não termina

Quase sempre e o agendador do WordPress. Se o WP-Cron esta desligado, se as conexoes de loopback do host estão bloqueadas ou se os limites de PHP são atingidos, o UpdraftPlus não consegue retomar o job e o backup trava antes de concluir.

### O que e DISABLE_WP_CRON e como ele afeta o backup

DISABLE_WP_CRON e uma constante no wp-config.php que desliga o agendador interno do WordPress. Com ela em true, o UpdraftPlus não dispara a retomada automática do backup incremental. Remova a linha ou use um cron externo do servidor.

### Como faço um backup incremental pelo WP-CLI

Depois de criar um backup completo de base, rode o comando wp updraftplus backup --incremental no terminal com WP-CLI. Esse caminho contorna o agendador do navegador e e útil quando o WP-Cron e instavel no seu host.

### O backup incremental serve para restaurar o site inteiro

Sozinho, não. Na restauração o UpdraftPlus combina o backup completo de base com as camadas incrementais. Por isso e essencial preservar o backup completo correspondente; sem ele, os incrementais não reconstroem o site.

### Posso agendar backups incrementais automaticos

Sim. No UpdraftPlus Premium você define o intervalo em 'Files backup schedule' (a cada hora, 2, 4, 8, 12 horas ou diario). Para o agendamento funcionar de forma confiavel, garanta que o WP-Cron ou um cron externo esteja operante.

**Fonte:** [UpdraftPlus — How to create incremental backups in WordPress](https://teamupdraft.com/documentation/updraftplus/premium-features/how-to-create-incremental-backups-in-wordpress/)