为什么 WordPress 会提示"The link you followed has expired"(您点击的链接已过期)
修复 WordPress 上传时的链接已过期错误。了解 PHP 的 post_max_size 等限制如何导致问题,检查当前上限并选择合适的解决方法。
WordPress 之所以显示”The link you followed has expired”,通常是因为上传的内容超出了 PHP 的 post_max_size 限制。PHP 会丢弃整个请求,导致 WordPress 的安全 nonce 校验失败,而 WordPress 报告的正是这个校验失败,而不是文件大小错误。
你把一个 70 MB 的付费主题 zip 包拖进上传器,看着进度条走完,结果却跳出一个链接已过期的页面。这条提示让人以为是会话过期,但真正的问题出在服务器限制上。
本文将解释 PHP 为何会产生这条具有误导性的提示、哪三项设置控制着它、如何查看当前的限制值,以及哪种修复方法适用于你服务器运行 PHP 的方式。
要点速览
- 当请求超出
post_max_size时,PHP 会让$_POST和$_FILES保持为空,于是 WordPress 的 nonce 校验失败,并显示”The link you followed has expired”。 upload_max_filesize和post_max_size属于INI_PERDIR级别的设置,因此在 functions.php 或代码片段插件中调用ini_set()无法修改它们。- .htaccess 中的
php_value行仅在 PHP 以 Apache 模块方式运行时生效。在 PHP-FPM 下,请改用 .user.ini 或主机商提供的 PHP 设置。 - wp-config.php 中的
WP_MEMORY_LIMIT控制的是内存,而不是最大上传大小。 - 通过 SFTP 上传解压后的主题或插件文件夹,可以完全绕开 PHP 的上传限制。
为什么上传后会出现”链接已过期”
当请求体大于 post_max_size 时,PHP 会让 $_POST 和 $_FILES 都保持为空,这一点在 PHP 手册的 post_max_size 条目中有明确说明。WordPress 嵌入在上传表单中的 nonce 正是随这些被丢弃的数据一起传输的,因此 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,那些在 functions.php 或代码片段插件中对它们调用 ini_set() 的代码是不可能生效的。即便抛开可修改模式的规则不谈,在任何 WordPress 代码运行之前,PHP 就已经接收或丢弃了请求体。在调用前加上 @ 也只是隐藏了警告而已。另外,有些教程还会使用 upload_max_size,而这根本不是一个 PHP 指令。
如果文件超过了 upload_max_filesize 但未超过 post_max_size,失败的表现会有所不同。PHP 仍会传递表单数据,因此 WordPress 能够报告一个与文件大小相关的上传错误。由 max_execution_time 引起的超时表现也不同:通常你会看到关于最大执行时间的致命错误(fatal error)或网关超时,而不是”链接已过期”的提示。
如何查看当前的上传限制
WordPress 后台在两个地方显示实际生效的限制:
- 媒体 > 添加媒体文件(Media > Add Media File):在拖放区域下方显示”最大上传文件大小”(Maximum upload file size)。
- 工具 > 站点健康 > 信息(Tools > Site Health > Info):其中的服务器(Server)部分列出了 PHP 的上传和 POST 限制以及执行时间;媒体处理(Media Handling)部分显示实际生效的最大上传大小。
要确定应该编辑哪个文件,你还需要了解 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 选项”页面。在此处所做的修改会在服务器层面生效,无需编辑任何文件。建议优先尝试这种方法。
2. php.ini 或 .user.ini
在 VPS 上,编辑诊断文件所显示的已加载 php.ini,然后重启 PHP。在 CGI/FastCGI 环境(包括 PHP-FPM)下,在 WordPress 根目录创建一个 .user.ini 文件。两种文件的语法相同:
; 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.cache_ttl 秒重新读取一次 .user.ini,默认值为 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 描述为适用于以 Apache 模块方式运行的 PHP 的指令。在 PHP-FPM 下,Apache 无法识别该指令。视具体配置而定,它要么忽略这些行,要么返回 500 Internal Server Error。而 Nginx 则完全不读取 .htaccess。
无效的方法:wp-config.php
wp-config.php 无法提高上传限制。WP_MEMORY_LIMIT 设置的是 WordPress 向 PHP 申请的内存大小,对上传大小没有任何影响。如果修改配置后出现空白页面,请参阅 WordPress 白屏死机修复指南。
变通方案:通过 SFTP 上传主题或插件
你可以通过 SFTP 将解压后的主题或插件文件夹上传到 wp-content/themes 或 wp-content/plugins,从而完全绕开 PHP 的上传限制,因为这些文件根本不经过 PHP 请求。先在本地解压,然后执行:
sftp user@example.com
put -r my-theme /path/to/wp-content/themes/
远程路径因主机而异。文件夹就位后,在 外观 > 主题(Appearance > Themes)或 插件(Plugins)中启用即可。请使用 SFTP 而非普通 FTP,以免凭据以明文形式传输。OpenReplay 的如何保护 WordPress 网站指南介绍了这一点以及其他访问安全加固措施。
解决根本原因
“The link you followed has expired”通常意味着上传内容超过了 post_max_size,而不是会话过期。运行诊断文件,了解 PHP 在你的服务器上是如何运行的。然后在与之匹配的位置提高 upload_max_filesize 和 post_max_size:主机控制面板、php.ini 或 .user.ini,或者仅在 mod_php 下使用 .htaccess。在重新上传之前,先到站点健康中确认新值已生效。
常见问题
WordPress nonce 在过期前的有效期是多长?
默认情况下,WordPress nonce 的有效期在 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,任何超过该值的请求体都会被立即拒绝。请在处理 wp-admin 的 http、server 或 location 块中提高该值,然后重新加载 Nginx。之后仍需提高 PHP 的 upload_max_filesize 和 post_max_size;此外,站点前端的 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 能否在不受 PHP 上传限制的情况下安装主题或插件 zip 包?
可以。WP-CLI 在服务器命令行中运行,zip 包无需经由浏览器上传,因此 post_max_size 不会起作用。先通过 SFTP 将 zip 包复制到服务器,然后运行 wp theme install /path/to/theme.zip --activate 或 wp plugin install /path/to/plugin.zip --activate。这两条命令都支持 WordPress.org slug、本地 zip 路径或远程 zip URL。此方法需要 SSH 访问权限。
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