12k
All articles

Por que o WordPress exibe "O link que você seguiu expirou"

Corrija o erro de link expirado do WordPress ao enviar arquivos. Verifique os limites do PHP, como post_max_size, e aplique a solução adequada.

OpenReplay Team
OpenReplay Team
Por que o WordPress exibe "O link que você seguiu expirou"

O WordPress geralmente exibe “O link que você seguiu expirou” (“The link you followed has expired”, na versão em inglês) porque o upload excedeu o limite post_max_size do PHP. O PHP descarta a requisição inteira, a verificação do nonce de segurança do WordPress falha, e o WordPress relata essa falha em vez de um erro de tamanho de arquivo.

Você arrasta o arquivo zip de 70 MB de um tema premium para o uploader, vê a barra de progresso chegar ao fim e recebe uma página dizendo que o link expirou. A mensagem sugere uma sessão expirada, mas o problema real é um limite do servidor.

Este artigo explica por que o PHP gera essa mensagem enganosa, quais três configurações a controlam, como consultar seus limites atuais e qual correção funciona para a forma como o PHP é executado no seu servidor.

Principais conclusões

  • Quando uma requisição excede post_max_size, o PHP deixa $_POST e $_FILES vazios, então a verificação de nonce do WordPress falha e ele exibe “O link que você seguiu expirou”.
  • upload_max_filesize e post_max_size são configurações INI_PERDIR, portanto ini_set() no functions.php ou em um plugin de snippets não consegue alterá-las.
  • Linhas php_value no .htaccess só funcionam quando o PHP é executado como módulo do Apache. No PHP-FPM, use o .user.ini ou as configurações de PHP da sua hospedagem.
  • WP_MEMORY_LIMIT no wp-config.php controla a memória, não o tamanho máximo de upload.
  • Enviar a pasta descompactada do tema ou plugin via SFTP contorna totalmente os limites de upload do PHP.

Quando o corpo de uma requisição é maior que post_max_size, o PHP deixa tanto $_POST quanto $_FILES vazios, conforme documentado na entrada sobre post_max_size do manual do PHP. O nonce que o WordPress incorporou ao formulário de upload trafega justamente nesses dados descartados, então o WordPress não consegue distinguir um upload grande demais de um envio forjado ou desatualizado. Ele recorre então à função wp_nonce_ays(), cuja saída padrão é “O link que você seguiu expirou.”, com status 403.

“O link que você seguiu expirou” também pode aparecer sem nenhum upload. Se uma página do painel administrativo ficar aberta por tempo suficiente, o nonce dela expira, e o envio do formulário gera o mesmo texto. Recarregar a página emite um nonce novo e resolve o problema.

As três configurações do PHP por trás do erro

Três diretivas do PHP controlam uploads grandes no WordPress: upload_max_filesize, post_max_size e max_execution_time. Duas delas causam o erro de link expirado:

DiretivaO que ela limitaAlterável com ini_set()?
upload_max_filesizeCada arquivo enviadoNão (INI_PERDIR)
post_max_sizeO corpo inteiro da requisiçãoNão (INI_PERDIR)
max_execution_timeTempo de execução do script, em segundosSim

post_max_size deve ser configurado com um valor um pouco maior que upload_max_filesize, porque a requisição também carrega campos de formulário e delimitadores multipart. A documentação do PHP afirma que, para enviar arquivos grandes, post_max_size deve ser maior que upload_max_filesize. A mesma página lista as duas diretivas de tamanho como INI_PERDIR. Segundo o manual do PHP sobre os modos, configurações INI_PERDIR podem ser definidas no php.ini, .htaccess, httpd.conf ou .user.ini, mas não a partir de um script em execução.

Como as duas diretivas de tamanho são INI_PERDIR, snippets que chamam ini_set() para elas no functions.php ou em um plugin de snippets não têm como funcionar. Mesmo deixando de lado a regra dos modos de alteração, o PHP já aceitou ou descartou o corpo da requisição antes que qualquer código do WordPress seja executado. Um @ na frente da chamada apenas oculta o aviso. Alguns tutoriais também usam upload_max_size, que nem sequer é uma diretiva do PHP.

Um arquivo que ultrapassa upload_max_filesize, mas fica abaixo de post_max_size, falha de outra forma. O PHP ainda entrega os dados do formulário, então o WordPress consegue reportar um erro de upload específico de tamanho. Um timeout causado por max_execution_time também tem outra aparência: normalmente você recebe um erro fatal sobre o tempo máximo de execução ou um gateway timeout, e não a mensagem de link expirado.

Como verificar seus limites de upload atuais

O WordPress mostra o limite efetivo em dois lugares no painel administrativo:

  1. Mídia > Adicionar arquivo de mídia exibe “Tamanho máximo de arquivo para upload” abaixo da área de arrastar e soltar.
  2. Ferramentas > Saúde do site > Informação tem uma seção Servidor que lista os limites de upload e de post do PHP, além do tempo de execução. A seção Manipulação de mídia mostra o tamanho máximo efetivo de upload.

Para descobrir qual arquivo editar, você também precisa saber como o PHP é executado. Coloque este arquivo temporário na raiz web, abra-o no navegador e depois exclua-o, porque ele expõe detalhes do servidor:

<?php
echo 'SAPI: ' . PHP_SAPI . "\n";
echo 'Loaded php.ini: ' . (php_ini_loaded_file() ?: 'none') . "\n";
echo 'user_ini.filename: ' . ini_get('user_ini.filename') . "\n";
foreach (['upload_max_filesize', 'post_max_size', 'max_execution_time'] as $k) {
    echo $k . ': ' . ini_get($k) . "\n";
}

O que o valor de SAPI significa:

  • apache2handler: o PHP é executado como módulo do Apache, então você pode usar o .htaccess ou o php.ini.
  • fpm-fcgi ou cgi-fcgi: use o .user.ini ou o painel da sua hospedagem, e nunca php_value.

Como aumentar os limites de upload do PHP, do mais fácil ao mais complexo

Todos os métodos abaixo aumentam os limites de upload alterando a configuração do PHP antes de a requisição ser processada. Esse é o único ponto em que esses limites podem ser alterados. Algumas hospedagens desativam um ou mais desses métodos, então, se uma alteração não aparecer na Saúde do site, tente o próximo método ou consulte a hospedagem.

1. Painel de controle da hospedagem

A maioria das hospedagens gerenciadas e compartilhadas oferece uma tela de configurações de PHP ou “Opções do PHP”. As alterações feitas ali se aplicam no nível do servidor e não exigem a edição de arquivos. Tente essa opção primeiro.

2. php.ini ou .user.ini

Em uma VPS, edite o php.ini carregado indicado pelo arquivo de diagnóstico e reinicie o PHP. Em configurações CGI/FastCGI, incluindo o PHP-FPM, crie um arquivo .user.ini na raiz do WordPress. Os dois arquivos usam a mesma sintaxe:

; Example values — adjust to your largest expected upload
upload_max_filesize = 64M
post_max_size = 128M
max_execution_time = 300

Sempre inclua o sufixo da unidade. O PHP interpreta um número inteiro sem unidade como bytes, então 128 significa 128 bytes.

A página do manual do PHP sobre o .user.ini explica que o PHP procura o arquivo no diretório do script requisitado e em cada diretório pai até a raiz do documento (document root). O PHP relê o .user.ini a cada user_ini.cache_ttl segundos, cujo padrão é 300. Portanto, uma alteração no .user.ini pode levar até cinco minutos para entrar em vigor. user_ini.cache_ttl é uma configuração de nível de sistema, então não é possível reduzi-la pelo .user.ini.

3. .htaccess (somente Apache com mod_php)

# Example values — Apache with PHP as a module only
php_value upload_max_filesize 64M
php_value post_max_size 128M
php_value max_execution_time 300

A documentação do PHP sobre como alterar configurações descreve php_value como uma diretiva para o PHP executado como módulo do Apache. No PHP-FPM, o Apache não reconhece a diretiva. Dependendo da configuração, ele ignora a linha ou responde com um 500 Internal Server Error. O Nginx não lê o .htaccess em hipótese alguma.

O que não funciona: wp-config.php

O wp-config.php não consegue aumentar o limite de upload. WP_MEMORY_LIMIT define quanta memória o WordPress solicita ao PHP e não tem efeito algum sobre o tamanho do upload. Se uma alteração de configuração deixar você com uma página em branco, veja a correção para a tela branca da morte do WordPress.

Alternativa: enviar o tema ou plugin via SFTP

Você pode contornar totalmente os limites de upload do PHP enviando a pasta descompactada do tema ou plugin para wp-content/themes ou wp-content/plugins via SFTP. Os arquivos nunca passam por uma requisição PHP. Descompacte localmente e depois execute:

sftp user@example.com
put -r my-theme /path/to/wp-content/themes/

O caminho remoto varia conforme a hospedagem. Depois que a pasta estiver no lugar, ative-a em Aparência > Temas ou em Plugins. Use SFTP em vez de FTP simples para que suas credenciais não sejam enviadas em texto puro. O guia da OpenReplay sobre como proteger um site WordPress aborda esse e outros reforços de segurança de acesso.

Corrigindo a causa real

“O link que você seguiu expirou” geralmente significa que o upload foi maior que post_max_size, e não que uma sessão expirou. Execute o arquivo de diagnóstico para ver como o PHP é executado no seu servidor. Em seguida, aumente upload_max_filesize e post_max_size no local correspondente: o painel da sua hospedagem, o php.ini ou .user.ini, ou o .htaccess apenas com mod_php. Confira os novos valores na Saúde do site antes de tentar o upload novamente.

Perguntas frequentes

Por quanto tempo um nonce do WordPress permanece válido antes de expirar?

Por padrão, um nonce do WordPress permanece válido por um período entre 12 e 24 horas. O filtro nonce_life tem como padrão DAY_IN_SECONDS (86.400 segundos), e o WordPress divide esse período em dois ticks de 12 horas, aceitando o tick atual e o anterior. Por isso, um formulário do painel administrativo deixado aberto durante a noite pode falhar com a mensagem de link expirado. Desenvolvedores podem alterar esse tempo de vida com o filtro nonce_life, mas reduzi-lo globalmente torna esses erros mais frequentes.

Por que recebo um erro 413 Request Entity Too Large em vez da mensagem de link expirado?

Um erro 413 significa que o Nginx rejeitou o upload antes que o PHP o recebesse. A diretiva client_max_body_size do Nginx tem como padrão 1m, e qualquer corpo de requisição acima desse valor é recusado imediatamente. Aumente-a no bloco http, server ou location que atende o wp-admin e, em seguida, recarregue o Nginx. Depois disso, ainda será necessário aumentar upload_max_filesize e post_max_size do PHP, e uma CDN ou um proxy reverso na frente do site pode impor seu próprio limite.

Por que o WordPress exibe um tamanho máximo de upload menor que o valor de upload_max_filesize?

O WordPress exibe como tamanho máximo de upload o menor valor entre upload_max_filesize e post_max_size, por meio da função wp_max_upload_size(). Se upload_max_filesize for 256M, mas post_max_size for 64M, o limite efetivo será 64M. Aumentar apenas uma das diretivas deixa o limite exibido inalterado. Configure post_max_size com um valor um pouco acima de upload_max_filesize e depois confirme os dois valores na seção Servidor da Saúde do site.

O WP-CLI consegue instalar o zip de um tema ou plugin sem esbarrar nos limites de upload do PHP?

Sim. O WP-CLI é executado na linha de comando do servidor, então o zip nunca passa por um upload via navegador e post_max_size não se aplica. Copie o zip para o servidor via SFTP e execute wp theme install /path/to/theme.zip --activate ou wp plugin install /path/to/plugin.zip --activate. Os dois comandos aceitam um slug do WordPress.org, o caminho de um zip local ou a URL de um zip remoto. É necessário ter acesso SSH.

DevTools for the frontend

Gain Debugging Superpowers

Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers.

Star on GitHub12k

We use cookies to improve your experience. By using our site, you accept cookies.