php静态资源分离是高并发下必须实施的减负措施,否则nginx会将js/css/jpg等请求错误交由php-fpm处理,导致进程占用、i/o增加且无法利用nginx原生缓存与压缩优化。

PHP 静态资源分离不是“可选项”,而是高并发场景下必须做的减负动作——不分离,Nginx 就会把 js、css、jpg 这类请求反复交给 PHP-FPM 处理,白白消耗进程和内存。
为什么 PHP 项目默认会误处理静态文件
Apache 或 Nginx 默认未显式拦截静态后缀时,若配置了 try_files $uri $uri/ /index.php?$query_string(常见于 Laravel、ThinkPHP),所有未命中真实文件的请求都会兜底到 index.php。这意味着:/static/logo.png 实际被 PHP 解析了一次,哪怕它只是个图片。
- PHP-FPM 进程被占用,无法及时响应真实业务请求
- 磁盘 I/O 增加(PHP 要打开文件、读取、再输出)
- 无法利用 Nginx 原生的
expires缓存、gzip 压缩等优化能力
Nginx 中拦截静态资源的 location 规则怎么写
关键不是“匹配什么”,而是“在哪儿写、顺序怎么排”。必须放在 location ~ \.php$ 之前,否则会被 PHP 的正则先捕获。
推荐写法(放在 server 块内,靠前位置):
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot|pdf)$ {
root /var/www/myapp/public;
expires 1y;
add_header Cache-Control "public, immutable";
access_log off;
}
-
~*表示大小写不敏感匹配,避免.JPG漏掉 -
root必须指向静态文件实际存放路径(不是 PHP 入口目录),常见错误是错写成/var/www/myapp导致 404 -
expires 1y和immutable能让浏览器长期缓存,减少重复请求 -
access_log off可显著降低日志 I/O 压力,尤其对小图、字体等高频请求
动静分离后如何处理版本化资源(如 app.a1b2c3.js)
前端构建生成带哈希值的文件名(例如 app.f3d8a2.js),本质是为绕过强缓存。此时不能依赖 expires,而要靠 Nginx 的 try_files + 文件系统存在性判断。
典型做法是:让构建产物统一放在 /public/build/ 下,并启用如下配置:
location ^~ /build/ {
alias /var/www/myapp/public/build/;
expires 1y;
add_header Cache-Control "public, immutable";
}
- 用
^~而非~*,确保前缀匹配优先级高于正则,避免被\.js$规则干扰 -
alias和root行为不同:alias会替换匹配路径,root是拼接路径;此处必须用alias,否则/build/app.js会去查/public/build/build/app.js - 如果使用 CDN,直接把
/build/目录挂载到 OSS 或 CDN 回源地址,Nginx 层就彻底不走磁盘了
分离后还要注意的三个隐蔽坑
很多团队做了分离却没效果,问题往往藏在这几个地方:
- PHP 框架里写了绝对路径
http://example.com/css/app.css,但实际资源已迁到https://cdn.example.com/css/app.css—— 浏览器仍向原站发起请求,Nginx 还是得处理 - 开发环境用了 webpack-dev-server 的
publicPath,生产环境没同步改造成 CDN 地址,导致资源 404 - 某些 PHP 扩展(如 xdebug)或调试工具(如 Laravel Telescope)会注入额外 JS/CSS 到页面,这些资源不在你定义的静态规则里,仍走 PHP 解析
真正完成动静分离,不在于配了多少条 location,而在于确认每一条浏览器发出的 GET 请求,其响应头中 X-Powered-By 是否消失、Content-Type 是否正确、且 Nginx access_log 中不再出现对应静态路径的 PHP-FPM 日志行。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











