ThinkPHP伪静态规则排除静态资源请求的配置说明【说明】

絕刀狂花

絕刀狂花

2026-06-27

745人浏览

原创

nginx的if (!-e $request_filename)会拦截/uploads图片,因其作为兜底逻辑,只要路径未真实存在(如alias未配对、权限不足或大小写不一致),就触发重写至index.php,导致php无法输出jpg而返回404;可靠解法是优先用location ^~ /uploads/ { alias ...; }跳过伪静态,或在rewrite正则中用^(?!uploads|...)(.*)$显式排除。

thinkphp伪静态规则排除静态资源请求的配置说明【说明】

为什么Nginx的if (!-e $request_filename)会拦截/uploads图片

因为这条规则是「兜底逻辑」:只要请求路径在磁盘上找不到对应的真实文件或目录,就强制重写到 index.php。而 /uploads/2024/01/test.jpg 看似是静态路径,但如果 Nginx 的 rootalias 没配对、权限不对、或路径大小写不一致,!-e $request_filename 就会返回 true,触发重写——结果请求被发给 PHP,而 PHP 显然不会输出 JPG 文件,最终 404。

Nginx中排除/uploads等路径的两种可靠写法

不能只靠 if 判断,必须让 Nginx 在进入伪静态逻辑前就「跳过检查」这些目录:

PHP 8.5.5
PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。

下载
  • location ^~ /uploads/ 独立块 + alias,优先级高于 location /,直接命中即返回静态文件,不走任何 rewrite 或 try_files fallback
  • 若坚持用 if + rewrite,必须在 rewrite 正则里显式排除,例如:rewrite ^/(?!uploads|storage|static|public\/storage)(.*)$ /public/index.php?s=$1 last; —— 注意 ?!uploads 是负向先行断言,且路径名要和实际 URL 路径完全一致(比如是 /uploads 就不能写成 /Uploads

Apache下如何安全放行真实静态资源

Apache 的 .htaccess 规则顺序决定一切。常见错误是把放行静态资源的条件写在 ThinkPHP 主规则之后,导致已存在的 /uploads/xxx.png 仍被重写。

  • 必须把 RewriteCond %{REQUEST_FILENAME} -f-d 放在所有重写规则之前,这是 ThinkPHP 官方规则能工作的前提
  • 如果项目用了软链接(如 public/storage → ../storage/app/public),-f 判断默认不跟随符号链接,需加 -L 条件:RewriteCond %{REQUEST_FILENAME} -f [OR] RewriteCond %{REQUEST_FILENAME} -L
  • 不要手动添加针对 .jpg.css 的单独 RewriteRule,这容易和框架路由冲突;信任 !-f + !-d 组合即可

容易被忽略的路径细节:大小写、末尾斜杠、子目录前缀

伪静态失效的多数 case 不是规则写错,而是路径没对齐:

  • alias /var/www/app/public/uploads/ 末尾必须有斜杠,否则 Nginx 会拼出错误物理路径
  • URL 访问的是 /uploads/IMG.JPG,但磁盘文件是 img.jpg,Linux 下直接 404 —— 别依赖“自动转小写”,改文件名或加 underscores_in_headers on; 无用,得统一命名规范
  • 项目部署在子目录(如 https://a.com/myapp/),location / 必须改成 location /myapp/,且 alias 指向的是 /var/www/html/myapp/public,不是 /var/www/html/myapp/public/myapp

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

5528

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

3630

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

1808

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

2294

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

2831

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

2021

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

3075

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

2340

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

10931

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习