12k
All articles

Почему WordPress выдаёт «The link you followed has expired»

Исправьте ошибку WordPress об истекшей ссылке при загрузке файлов. Проверьте лимиты PHP, включая post_max_size, и выберите подходящее решение.

OpenReplay Team
OpenReplay Team
Почему WordPress выдаёт «The link you followed has expired»

Обычно WordPress показывает сообщение «The link you followed has expired», когда размер загружаемого файла превышает лимит PHP post_max_size. PHP отбрасывает весь запрос, проверка nonce (одноразового токена безопасности) не проходит, и WordPress сообщает об этой ошибке вместо ошибки размера файла.

Вы перетаскиваете zip-архив премиум-темы на 70 МБ в загрузчик, индикатор прогресса доходит до конца, а в ответ открывается страница об истёкшей ссылке. Сообщение намекает на устаревшую сессию, но на самом деле проблема в серверном лимите.

В этой статье разберём, почему PHP приводит к этому вводящему в заблуждение сообщению, какие три настройки за него отвечают, как узнать текущие лимиты и какое решение подходит для вашего способа запуска PHP на сервере.

Основные выводы

  • Если запрос превышает post_max_size, PHP оставляет $_POST и $_FILES пустыми, проверка nonce в WordPress не проходит, и появляется сообщение «The link you followed has expired».
  • upload_max_filesize и post_max_size относятся к настройкам режима INI_PERDIR, поэтому изменить их через ini_set() в functions.php или в плагине для сниппетов нельзя.
  • Строки php_value в .htaccess работают, только когда PHP запущен как модуль Apache. При PHP-FPM используйте .user.ini или настройки PHP в панели хостинга.
  • WP_MEMORY_LIMIT в wp-config.php управляет памятью, а не максимальным размером загрузки.
  • Загрузка распакованной папки темы или плагина по SFTP полностью обходит лимиты PHP на загрузку.

Когда тело запроса превышает post_max_size, PHP оставляет и $_POST, и $_FILES пустыми — это описано в разделе руководства PHP о post_max_size. Nonce, который WordPress встраивает в форму загрузки, передаётся как раз в этих отброшенных данных, поэтому WordPress не может отличить слишком большую загрузку от поддельной или устаревшей отправки формы. В результате срабатывает wp_nonce_ays(), которая по умолчанию выводит «The link you followed has expired.» с кодом статуса 403.

Сообщение «The link you followed has expired» может появиться и без всякой загрузки. Если страница админки достаточно долго остаётся открытой, срок действия её nonce истекает, и отправка формы приводит к тому же тексту. Перезагрузка страницы выдаёт новый nonce и решает проблему.

Три настройки PHP, стоящие за ошибкой

Загрузку больших файлов в WordPress контролируют три директивы PHP: upload_max_filesize, post_max_size и max_execution_time. Ошибку об истёкшей ссылке вызывают две из них:

ДирективаЧто ограничиваетМожно изменить через ini_set()?
upload_max_filesizeКаждый загружаемый файлНет (INI_PERDIR)
post_max_sizeВсё тело запросаНет (INI_PERDIR)
max_execution_timeВремя выполнения скрипта в секундахДа

Значение post_max_size должно быть немного больше upload_max_filesize, поскольку запрос, помимо файла, содержит поля формы и границы multipart. В документации PHP прямо сказано, что для загрузки больших файлов post_max_size должен быть больше upload_max_filesize. На той же странице обе директивы размера отнесены к режиму INI_PERDIR. Согласно руководству PHP о режимах изменения настроек, настройки INI_PERDIR можно задать в php.ini, .htaccess, httpd.conf или .user.ini, но не из выполняющегося скрипта.

Поскольку обе директивы размера относятся к INI_PERDIR, сниппеты, вызывающие для них ini_set() в functions.php или в плагине для сниппетов, работать не могут. Даже если не принимать во внимание правило режимов изменения, PHP принимает или отбрасывает тело запроса ещё до запуска какого-либо кода WordPress. Символ @ перед вызовом лишь скрывает предупреждение. Некоторые руководства также используют upload_max_size, но такой директивы в PHP вообще не существует.

Файл, размер которого превышает upload_max_filesize, но укладывается в post_max_size, приводит к другой ошибке. PHP всё равно передаёт данные формы, поэтому WordPress может сообщить о конкретной ошибке размера загрузки. Таймаут по max_execution_time тоже выглядит иначе: обычно вы получаете фатальную ошибку о превышении максимального времени выполнения или ошибку gateway timeout, а не сообщение об истёкшей ссылке.

Как проверить текущие лимиты загрузки

WordPress показывает действующий лимит в двух местах админки:

  1. Медиафайлы > Добавить медиафайл — под областью перетаскивания отображается «Максимальный размер загружаемого файла».
  2. Инструменты > Здоровье сайта > Информация — в разделе Сервер указаны лимиты PHP на загрузку и POST-запросы, а также время выполнения. В разделе Обработка медиафайлов показан действующий максимальный размер загрузки.

Чтобы понять, какой файл редактировать, нужно также знать, как запущен PHP. Разместите этот временный файл в корне сайта, откройте его в браузере, а затем удалите, так как он раскрывает сведения о сервере:

<?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";
}

Что означает значение SAPI:

  • apache2handler: PHP работает как модуль Apache, поэтому можно использовать .htaccess или php.ini.
  • fpm-fcgi или cgi-fcgi: используйте .user.ini или панель хостинга и ни в коем случае не php_value.

Как повысить лимиты загрузки PHP: от простого к сложному

Все перечисленные ниже способы повышают лимиты загрузки, изменяя конфигурацию PHP до разбора запроса. Только там эти лимиты и можно изменить. Некоторые хостинги отключают один или несколько из этих способов, поэтому если изменение не отображается в «Здоровье сайта», попробуйте следующий способ или обратитесь к хостеру.

1. Панель управления хостингом

Большинство управляемых и виртуальных хостингов предоставляют экран настроек PHP или «PHP options». Изменения, внесённые там, применяются на уровне сервера и не требуют редактирования файлов. Начните с этого способа.

2. php.ini или .user.ini

На VPS отредактируйте загруженный php.ini, путь к которому показал диагностический файл, и перезапустите PHP. В конфигурациях CGI/FastCGI, включая PHP-FPM, создайте файл .user.ini в корне WordPress. Оба файла используют одинаковый синтаксис:

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

Всегда указывайте суффикс единицы измерения. PHP интерпретирует число без суффикса как байты, то есть 128 означает 128 байт.

На странице руководства PHP о .user.ini поясняется, что PHP ищет этот файл в каталоге запрашиваемого скрипта и во всех родительских каталогах вплоть до корня документов. PHP перечитывает .user.ini каждые user_ini.cache_ttl секунд (по умолчанию 300). Поэтому изменения в .user.ini могут вступить в силу только через пять минут. user_ini.cache_ttl — системная настройка, поэтому сократить этот интервал через .user.ini нельзя.

3. .htaccess (только Apache с 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

В документации PHP об изменении настроек конфигурации php_value описана как директива для PHP, работающего в качестве модуля Apache. При PHP-FPM Apache эту директиву не распознаёт. В зависимости от конфигурации он либо игнорирует строку, либо отвечает ошибкой 500 Internal Server Error. Nginx вообще не читает .htaccess.

Что не работает: wp-config.php

Через wp-config.php повысить лимит загрузки нельзя. WP_MEMORY_LIMIT задаёт объём памяти, который WordPress запрашивает у PHP, и никак не влияет на размер загрузки. Если после изменения конфигурации вы видите пустую страницу, обратитесь к руководству по устранению «белого экрана смерти» WordPress.

Обходной путь: загрузка темы или плагина по SFTP

Лимиты загрузки PHP можно обойти полностью, загрузив распакованную папку темы или плагина в wp-content/themes или wp-content/plugins по SFTP. В этом случае файлы вообще не проходят через PHP-запрос. Распакуйте архив локально, а затем выполните:

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

Путь на удалённом сервере зависит от хостинга. Когда папка окажется на месте, активируйте тему в разделе «Внешний вид > Темы» или плагин в разделе «Плагины». Используйте SFTP, а не обычный FTP, чтобы учётные данные не передавались открытым текстом. Об этом и других мерах по защите доступа рассказывается в руководстве OpenReplay о том, как обезопасить сайт на WordPress.

Устранение истинной причины

Сообщение «The link you followed has expired» обычно означает, что загружаемый файл оказался больше post_max_size, а вовсе не то, что истекла сессия. Запустите диагностический файл, чтобы узнать, как PHP работает на вашем сервере. Затем повысьте upload_max_filesize и post_max_size в подходящем месте: в панели хостинга, в php.ini или .user.ini, либо в .htaccess — только при mod_php. Прежде чем повторить загрузку, проверьте новые значения в «Здоровье сайта».

Часто задаваемые вопросы

Как долго nonce в WordPress остаётся действительным?

По умолчанию nonce в WordPress действителен от 12 до 24 часов. Фильтр nonce_life по умолчанию возвращает DAY_IN_SECONDS (86 400 секунд), и WordPress делит этот период на два 12-часовых интервала (tick), принимая nonce текущего и предыдущего интервала. Поэтому форма в админке, оставленная открытой на ночь, может выдать сообщение об истёкшей ссылке. Разработчики могут изменить срок действия с помощью фильтра nonce_life, но его глобальное сокращение приведёт к тому, что такие ошибки будут возникать чаще.

Почему вместо сообщения об истёкшей ссылке я получаю ошибку 413 Request Entity Too Large?

Ошибка 413 означает, что Nginx отклонил загрузку ещё до того, как запрос попал в PHP. Директива Nginx client_max_body_size по умолчанию равна 1m, и любой запрос с телом большего размера сразу отклоняется. Увеличьте её значение в блоке http, server или location, который обрабатывает wp-admin, и перезагрузите Nginx. После этого всё равно потребуется повысить upload_max_filesize и post_max_size в PHP, а CDN или обратный прокси перед сайтом может применять собственный лимит.

Почему WordPress показывает максимальный размер загрузки меньше, чем значение upload_max_filesize?

WordPress с помощью функции wp_max_upload_size() показывает в качестве максимального размера загрузки меньшее из значений upload_max_filesize и post_max_size. Если upload_max_filesize равен 256M, а post_max_size — 64M, действующий лимит составит 64M. Если повысить только одну директиву, отображаемый лимит не изменится. Установите post_max_size немного больше upload_max_filesize, а затем проверьте оба значения в разделе «Сервер» в «Здоровье сайта».

Может ли WP-CLI установить zip-архив темы или плагина, не упираясь в лимиты загрузки PHP?

Да. WP-CLI работает в командной строке сервера, поэтому zip-архив не передаётся через загрузку в браузере, и post_max_size на него не распространяется. Скопируйте архив на сервер по SFTP, а затем выполните wp theme install /path/to/theme.zip --activate или wp plugin install /path/to/plugin.zip --activate. Обе команды принимают slug с WordPress.org, путь к локальному zip-архиву или URL удалённого архива. Для этого нужен доступ по 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.