# Como corrigir o erro de tamanho de backup que excede o limite no UpdraftPlus

O erro de tamanho de backup que excede o limite no UpdraftPlus acontece quando um arquivo zip ultrapassa o ponto de divisao (1 GB por padrão), o teto de upload do destino remoto ou os limites de PHP, fazendo o backup falhar ou parar pela metade.

## O que é erro de tamanho de backup que excede o limite no UpdraftPlus?

No UpdraftPlus, cada backup empacota arquivos do site em arquivos zip. Por padrão, o plugin inicia um novo zip a cada 1 GB, controlado pela opção Split every nas Expert settings. Quando esse valor esta alto demais, quando o destino remoto rejeita arquivos acima de um teto próprio, ou quando o PHP não tem memória e tempo para manipular um zip enorme, o backup falha com aviso de tamanho excedido ou interrompe a transferencia no meio.

O resultado pratico e um backup incompleto: ou ele nunca termina de gerar o zip, ou o arquivo e gerado mas não sobe inteiro para o destino. A correção passa por reduzir o tamanho de cada zip, alinhar esse tamanho ao limite do destino remoto e dar ao PHP recursos suficientes para processar os arquivos.

## Como identificar

- Mensagem no log do backup do tipo 'The backup archive files have been processed, but with some warnings' seguida de aviso de tamanho, na aba Settings -> UpdraftPlus Backups -> Existing Backups
- Mensagem 'A zip file (could not be opened / was too large)' ou aviso de que o arquivo excede o limite, no painel de progresso do backup
- Backup trava em uma porcentagem fixa (por exemplo 80 por cento) e nunca conclui, visivel na barra de progresso do UpdraftPlus
- Erro 'Allowed memory size of X bytes exhausted' no debug.log enquanto o UpdraftPlus monta o zip
- Upload para o destino remoto retorna falha por arquivo grande demais (por exemplo limite de 100 MB por arquivo no destino), registrado na linha de log do UpdraftPlus

## Como prevenir

- Mantenha o Split every em um valor abaixo do teto por arquivo do seu destino remoto, não no padrão de 1024 MB
- Use a opção de excluir uploads pesados ou pastas de cache do backup de arquivos, reduzindo o tamanho total empacotado
- Monitore o espaco em disco do servidor e remova backups locais antigos da pasta wp-content/updraft regularmente
- Mantenha memory_limit e max_execution_time do PHP folgados para sites grandes, em vez do mínimo do host

## Causa

- A opção Split every nas Expert settings esta no padrão de 1024 MB, gerando um único zip grande que o servidor não consegue manipular ou enviar.
- O destino remoto tem teto próprio de tamanho por arquivo menor que o zip gerado (por exemplo o limite de tamanho de chunk em alguns provedores), entao o arquivo dividido ainda fica maior que o aceito.
- O limite memory_limit do PHP esta baixo (por exemplo 128M) e o processo morre ao manipular um zip na casa de gigabytes.
- O max_execution_time do PHP encerra o processo antes de o zip grande terminar de ser montado ou enviado.
- Falta espaco livre em disco no servidor para criar o zip temporario, exigido durante a geração do backup (o UpdraftPlus precisa de espaco igual ao tamanho dos dados sendo empacotados).

## Como resolver

1. Reduza o tamanho de cada arquivo zip nas Expert settings: Abra as configurações do plugin, role até a seção avancada e diminua o valor que define quando um novo zip e iniciado. Um valor menor faz o UpdraftPlus quebrar o backup em vários arquivos pequenos, que são mais fáceis de montar e enviar. Comece reduzindo de 1024 para 400.

```
Settings -> UpdraftPlus Backups -> Settings -> Expert settings -> Show expert settings
Split every: 400 (MB)
```

2. Alinhe o tamanho do split ao teto do destino remoto: Confira o limite de tamanho por arquivo do seu destino (Google Drive, Dropbox, Amazon S3, FTP). Defina o valor de Split every abaixo desse teto, para que nenhum pedaco do backup ultrapasse o que o destino aceita por arquivo. Se o destino aceita até 100 MB por upload, use um split de 90.

```
Split every: 90 (MB)
```

3. Aumente memória e tempo de execução do PHP: Eleve os limites do PHP para que o processo consiga manipular os arquivos sem ser encerrado no meio. Adicione as linhas abaixo ao wp-config.php logo antes da linha que pede para parar de editar, e ajuste o php.ini ou o equivalente do seu host.

```
define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );
memory_limit = 512M
max_execution_time = 300
```

4. Garanta espaco livre em disco e refaca o backup: O UpdraftPlus precisa de espaco temporario em disco equivalente ao tamanho dos dados que esta empacotando. Limpe a pasta de backups antigos e confirme o espaco livre antes de disparar um novo backup manual. Depois, rode o backup novamente e acompanhe o log até concluir.

```
wp-content/updraft/
df -h
Settings -> UpdraftPlus Backups -> Backup Now
```


## Código

```php
/* wp-config.php: eleva memoria do WordPress para o UpdraftPlus manipular zips grandes */
define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

/* Reduz, via filtro, o limite de tempo que o UpdraftPlus dedica a cada fatia
   do backup, forcando mais ciclos curtos em vez de um unico ciclo longo que estoura. */
add_filter( 'updraftplus_time_to_finish', function( $time ) {
    return 20; // segundos por ciclo de resumo (resumption)
} );
```

## Perguntas frequentes

### Por que o backup do UpdraftPlus diz que excede o limite de tamanho?

Porque um arquivo zip do backup passou de um teto: o ponto de divisao Split every (1 GB por padrão), o limite por arquivo do destino remoto, ou o que o PHP consegue manipular. Quando o zip fica maior que algum desses tetos, o backup falha ou para pela metade.

### O que e a opção Split every no UpdraftPlus?

E a configuração, nas Expert settings, que define o tamanho máximo de cada arquivo zip antes de o plugin iniciar um novo. O padrão e iniciar um zip novo a cada 1 GB. Reduzir esse valor quebra o backup em mais arquivos menores, mais fáceis de montar e enviar.

### Qual valor de Split every devo usar?

Use um valor menor que o limite por arquivo do seu destino remoto. Se o destino aceita arquivos de até 100 MB, defina o split em torno de 90 MB. Para servidores com pouca memória, valores entre 200 e 400 MB ajudam a evitar travamentos na montagem do zip.

### Reduzir o tamanho do zip deixa o backup mais lento?

Pode adicionar um pequeno custo, porque o plugin gera mais arquivos, mas e muito mais confiavel. Backups divididos em pedacos pequenos terminam de subir mesmo em hospedagens com limite de tempo e teto de tamanho por upload, evitando o backup incompleto.

### Preciso de plano pago do UpdraftPlus para mudar o tamanho do backup?

Não. A opção Split every fica nas Expert settings da versão gratuita. O ajuste de tamanho de zip, memória e tempo de execução do PHP não depende de plano pago do plugin.

### O erro de tamanho pode vir de falta de espaco em disco?

Sim. O UpdraftPlus precisa de espaco temporario em disco para montar o zip antes de enviar. Se faltar espaco, o backup falha ou gera arquivos truncados. Limpe a pasta wp-content/updraft e confirme o espaco livre antes de refazer.

### Esse erro afeta a restauração do site?

Afeta indiretamente. Um backup que excedeu o limite e não concluiu fica incompleto, e restaurar a partir dele pode falhar ou deixar arquivos faltando. Sempre confirme no log que o backup terminou sem aviso de tamanho antes de confiar nele para restaurar.

**Fonte:** [UpdraftPlus — Can I split backups of large sites into multiple archives?](https://teamupdraft.com/documentation/updraftplus/topics/backing-up/faqs/how-to-split-backups-of-large-sites-into-multiple-archives/)
