12k
All articles

Por qué WordPress muestra «The link you followed has expired»

Corrige el error de enlace caducado de WordPress al subir archivos. Comprueba los límites PHP que lo causan y aplica la solución adecuada.

OpenReplay Team
OpenReplay Team
Por qué WordPress muestra «The link you followed has expired»

WordPress suele mostrar «The link you followed has expired» («El enlace que has seguido ha caducado») porque la subida superó el límite post_max_size de PHP. PHP descarta la petición completa, la comprobación del nonce de seguridad de WordPress falla y WordPress informa de ese fallo en lugar de mostrar un error de tamaño de archivo.

Arrastras al cargador un archivo zip de un tema premium de 70 MB, ves cómo la barra de progreso se completa y aparece una página sobre un enlace caducado. El mensaje sugiere una sesión obsoleta, pero el problema real es un límite del servidor.

Este artículo explica por qué PHP produce este mensaje engañoso, qué tres directivas lo controlan, cómo consultar tus límites actuales y qué solución funciona según la forma en que tu servidor ejecuta PHP.

Puntos clave

  • Cuando una petición supera post_max_size, PHP deja vacíos $_POST y $_FILES, por lo que la comprobación del nonce de WordPress falla y aparece «The link you followed has expired».
  • upload_max_filesize y post_max_size son directivas INI_PERDIR, así que ini_set() en functions.php o en un plugin de fragmentos de código no puede modificarlas.
  • Las líneas php_value en .htaccess solo funcionan cuando PHP se ejecuta como módulo de Apache. Con PHP-FPM, usa .user.ini o los ajustes de PHP de tu proveedor de hosting.
  • WP_MEMORY_LIMIT en wp-config.php controla la memoria, no el tamaño máximo de subida.
  • Subir la carpeta descomprimida de un tema o plugin por SFTP evita por completo los límites de subida de PHP.

Por qué el enlace que has seguido ha caducado tras una subida

Cuando el cuerpo de una petición es mayor que post_max_size, PHP deja vacíos tanto $_POST como $_FILES, tal como documenta la entrada sobre post_max_size del manual de PHP. El nonce que WordPress incrusta en el formulario de subida viaja dentro de esos datos descartados, por lo que WordPress no puede distinguir una subida demasiado grande de un envío falsificado u obsoleto. En ese caso recurre a wp_nonce_ays(), cuya salida predeterminada es «The link you followed has expired.» con un código de estado 403.

«The link you followed has expired» también puede aparecer sin que haya ninguna subida. Si una página de administración permanece abierta el tiempo suficiente, su nonce caduca y, al enviar el formulario, se muestra el mismo texto. Recargar la página genera un nonce nuevo y soluciona el problema.

Las tres directivas de PHP detrás del error

Tres directivas de PHP controlan las subidas grandes en WordPress: upload_max_filesize, post_max_size y max_execution_time. Dos de ellas provocan el error del enlace caducado:

DirectivaQué limita¿Se puede cambiar con ini_set()?
upload_max_filesizeCada archivo subidoNo (INI_PERDIR)
post_max_sizeEl cuerpo completo de la peticiónNo (INI_PERDIR)
max_execution_timeTiempo de ejecución del script en segundosSí

post_max_size debe configurarse con un valor algo superior a upload_max_filesize, porque la petición también incluye campos del formulario y delimitadores multipart. La documentación de PHP indica que, para subir archivos grandes, post_max_size debe ser mayor que upload_max_filesize. La misma página clasifica ambas directivas de tamaño como INI_PERDIR. Según el manual de PHP sobre los modos, las directivas INI_PERDIR pueden establecerse en php.ini, .htaccess, httpd.conf o .user.ini, pero no desde un script en ejecución.

Como ambas directivas de tamaño son INI_PERDIR, los fragmentos de código que llaman a ini_set() para modificarlas en functions.php o en un plugin de fragmentos no pueden funcionar. Incluso dejando de lado la regla de los modos de modificación, PHP ya ha aceptado o descartado el cuerpo de la petición antes de que se ejecute cualquier código de WordPress. Anteponer @ a la llamada solo oculta la advertencia. Algunos tutoriales también usan upload_max_size, que ni siquiera es una directiva de PHP.

Un archivo que supera upload_max_filesize pero no post_max_size falla de otra manera. PHP sigue entregando los datos del formulario, de modo que WordPress puede mostrar un error de subida específico relacionado con el tamaño. Un tiempo de espera agotado por max_execution_time también tiene un aspecto distinto: normalmente obtienes un error fatal sobre el tiempo máximo de ejecución o un gateway timeout, no el mensaje del enlace caducado.

Cómo consultar tus límites de subida actuales

WordPress muestra el límite efectivo en dos lugares del panel de administración:

  1. Medios > Añadir nuevo archivo de medios (Media > Add Media File) muestra «Tamaño máximo de archivo de subida» («Maximum upload file size») debajo de la zona para soltar archivos.
  2. Herramientas > Salud del sitio > Información (Tools > Site Health > Info) incluye una sección Servidor (Server) que muestra los límites de subida y de POST de PHP, así como el tiempo de ejecución. La sección Gestión de medios (Media Handling) muestra el tamaño máximo de subida efectivo.

Para saber qué archivo debes editar, también necesitas saber cómo se ejecuta PHP. Coloca este archivo temporal en la raíz web, ábrelo en un navegador y después elimínalo, ya que expone detalles del 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";
}

Qué significa el valor de SAPI:

  • apache2handler: PHP se ejecuta como módulo de Apache, así que puedes usar .htaccess o php.ini.
  • fpm-fcgi o cgi-fcgi: usa .user.ini o el panel de tu proveedor de hosting, y nunca php_value.

Cómo aumentar los límites de subida de PHP, de la opción más sencilla a la más compleja

Todos los métodos siguientes aumentan los límites de subida modificando la configuración de PHP antes de que se procese la petición. Es el único punto en el que pueden cambiarse estos límites. Algunos proveedores de hosting desactivan uno o varios de estos métodos, así que, si un cambio no se refleja en Salud del sitio, prueba el siguiente o consulta con tu proveedor.

1. Panel de control del hosting

La mayoría de los proveedores de hosting gestionado y compartido ofrecen una pantalla de ajustes de PHP u «opciones de PHP». Los cambios realizados ahí se aplican a nivel de servidor y no requieren editar archivos. Prueba esta opción primero.

2. php.ini o .user.ini

En un VPS, edita el php.ini cargado que muestra el archivo de diagnóstico y reinicia PHP. En configuraciones CGI/FastCGI, incluido PHP-FPM, crea un archivo .user.ini en la raíz de WordPress. Ambos archivos usan la misma sintaxis:

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

Incluye siempre el sufijo de unidad. PHP interpreta un número entero sin sufijo como bytes, de modo que 128 significa 128 bytes.

La página del manual de PHP sobre .user.ini explica que PHP busca el archivo en el directorio del script solicitado y en cada directorio superior hasta la raíz de documentos. PHP vuelve a leer .user.ini cada user_ini.cache_ttl segundos, valor que por defecto es 300. Por tanto, un cambio en .user.ini puede tardar hasta cinco minutos en aplicarse. user_ini.cache_ttl es una directiva de nivel de sistema, así que no puedes reducirla desde .user.ini.

3. .htaccess (solo Apache con 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

La documentación de PHP sobre cómo cambiar los ajustes de configuración describe php_value como una directiva para PHP ejecutándose como módulo de Apache. Con PHP-FPM, Apache no reconoce la directiva. Según la configuración, ignora la línea o responde con un error 500 Internal Server Error. Nginx no lee .htaccess en absoluto.

Lo que no funciona: wp-config.php

wp-config.php no puede aumentar el límite de subida. WP_MEMORY_LIMIT establece cuánta memoria solicita WordPress a PHP y no afecta al tamaño de subida. Si un cambio de configuración te deja con una página en blanco, consulta la solución a la pantalla blanca de la muerte de WordPress.

Alternativa: subir el tema o plugin por SFTP

Puedes saltarte por completo los límites de subida de PHP subiendo la carpeta descomprimida del tema o plugin a wp-content/themes o wp-content/plugins por SFTP. Los archivos nunca pasan por una petición de PHP. Descomprímelos en local y después ejecuta:

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

La ruta remota varía según el proveedor de hosting. Una vez que la carpeta esté en su sitio, actívala en Apariencia > Temas (Appearance > Themes) o en Plugins. Usa SFTP en lugar de FTP sin cifrar para que tus credenciales no se envíen en texto plano. La guía de OpenReplay sobre cómo proteger un sitio WordPress trata este y otros aspectos del refuerzo del acceso.

Cómo solucionar la causa real

«The link you followed has expired» suele significar que la subida superó post_max_size, no que haya caducado una sesión. Ejecuta el archivo de diagnóstico para ver cómo se ejecuta PHP en tu servidor. A continuación, aumenta upload_max_filesize y post_max_size en el lugar que corresponda: el panel de tu proveedor de hosting, php.ini o .user.ini, o .htaccess solo con mod_php. Comprueba los nuevos valores en Salud del sitio antes de volver a intentar la subida.

Preguntas frecuentes

¿Cuánto tiempo sigue siendo válido un nonce de WordPress antes de caducar?

Un nonce de WordPress es válido entre 12 y 24 horas de forma predeterminada. El filtro nonce_life tiene como valor por defecto DAY_IN_SECONDS (86 400 segundos), y WordPress divide ese periodo en dos intervalos (ticks) de 12 horas, aceptando el actual y el anterior. Por tanto, un formulario de administración que se deja abierto durante la noche puede fallar con el mensaje del enlace caducado. Los desarrolladores pueden cambiar la duración con el filtro nonce_life, pero reducirla de forma global hace que estos errores sean más frecuentes.

¿Por qué obtengo un error 413 Request Entity Too Large en lugar del mensaje del enlace caducado?

Un error 413 significa que Nginx rechazó la subida antes de que PHP la recibiera. La directiva client_max_body_size de Nginx tiene como valor predeterminado 1m, y cualquier cuerpo de petición que lo supere se rechaza de inmediato. Auméntala en el bloque http, server o location que gestiona wp-admin y, después, recarga Nginx. Aun así, tendrás que aumentar también upload_max_filesize y post_max_size de PHP, y una CDN o un proxy inverso situado delante del sitio puede aplicar su propio límite.

¿Por qué WordPress muestra un tamaño máximo de subida inferior a mi valor de upload_max_filesize?

WordPress muestra como tamaño máximo de subida el menor valor entre upload_max_filesize y post_max_size, mediante su función wp_max_upload_size(). Si upload_max_filesize es 256M pero post_max_size es 64M, el límite efectivo es 64M. Aumentar solo una de las directivas no cambia el límite mostrado. Configura post_max_size con un valor algo superior a upload_max_filesize y, después, confirma ambos valores en la sección Servidor de Salud del sitio.

¿Puede WP-CLI instalar el zip de un tema o plugin sin toparse con los límites de subida de PHP?

Sí. WP-CLI se ejecuta en la línea de comandos del servidor, por lo que el zip nunca pasa por una subida desde el navegador y post_max_size no se aplica. Copia el zip al servidor por SFTP y, después, ejecuta wp theme install /path/to/theme.zip --activate o wp plugin install /path/to/plugin.zip --activate. Ambos comandos aceptan un slug de WordPress.org, una ruta local a un zip o la URL remota de un zip. Requiere acceso 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.