phpenv 不处理 http 缓存头,expires 由 nginx 控制;需在 vhosts 配置文件的 location 块中设置 expires,如 location ~.(js|css|png|jpg)$ { root c:/phpenv/www; expires 1w; },且动态 php 内容不宜盲目使用 nginx expires。

phpEnv 本身不处理 HTTP 缓存头(如 Expires),它只是 Windows 下的 PHP 运行环境集成包;真正控制浏览器缓存过期时间的是 Web 服务器(如 Nginx 或 Apache),不是 phpEnv。
为什么在 phpEnv 里直接配 expires 没用
phpEnv 默认搭配的是 Nginx(也有 Apache 可选),但它的配置文件被封装在界面背后,用户看不到 nginx.conf 的完整结构。很多人误以为改 php.ini 或点几下 phpEnv 界面就能设置 Expires,结果发现浏览器始终没加缓存头——因为 expires 是 Nginx 的指令,必须写在 server 或 location 块里,且不能放在 http 顶层。
常见错误现象:
- 在 phpEnv 的“PHP 设置”页里修改
session.cache_expire,但图片/JS 仍无Cache-Control头 - 重启 phpEnv 后,
curl -I https://localhost/test.jpg返回中没有Expires或max-age - 手动在
php.ini里加header("Expires: ..."),但被 Nginx 的静态文件直出绕过(PHP 根本没执行)
Nginx 配置 expires 的正确位置(phpEnv 用户必看)
phpEnv 安装后,Nginx 配置通常位于:C:\phpEnv\nginx\conf\nginx.conf 或 C:\phpEnv\nginx\vhosts\ 下的站点配置文件。你必须把 expires 写进 location 块,而不是 http 或 server 的根层级(否则会报错 "expires directive is not allowed here")。
实操建议:
- 打开
C:\phpEnv\nginx\vhosts\your-site.conf(或default.conf) - 找到类似
location ~ \.(js|css|png|jpg|gif|ico|woff2?)$ {的块,如果没有就手动加一个 - 在里面加入
expires 1w;或expires max;(推荐先用1h测试) - 确保该
location块里有root或alias指向实际文件路径,否则 404 且expires不生效
示例片段:
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?|ttf|eot)$ {
root C:/phpEnv/www;
expires 1w;
}
动态内容(PHP 脚本)要不要加 expires
不要盲目加。Nginx 的 expires 对 proxy_pass 到 PHP-FPM 的请求默认不生效(除非显式开启 fastcgi_cache),而且 PHP 页面通常含用户状态、时间敏感数据,加了反而导致缓存脏数据。
如果你真需要控制 PHP 输出的缓存头:
- 在 PHP 脚本开头用
header("Cache-Control: public, max-age=3600");(注意:必须在任何输出前调用) - 避免混用:Nginx 的
expires和 PHP 的header()同时设,容易冲突;优先选其一 -
session.cache_limiter在php.ini中设为private或nocache,防止登录态页面被缓存(这是更关键的安全点)
容易被忽略的兼容性细节
HTTP/1.0 客户端只认 Expires,HTTP/1.1+ 才用 Cache-Control: max-age。Nginx 的 expires 指令会同时设置这两个头,但有个前提:
- 响应状态码必须是
200、201、301、302等可缓存状态;4xx、5xx响应永远不加缓存头 - 如果启用了
gzip,Nginx 内部已保证expires在压缩后写入响应头,无需调整顺序 - 使用
add_header Cache-Control "..."时,若值与expires冲突(比如一个设max-age=3600,另一个设no-cache),后者会覆盖前者
最后提醒:phpEnv 的 Nginx 版本较旧(常为 1.18 或 1.20),不支持 map 指令做 MIME 类型统一缓存控制,所以别照搬高级教程里的 map $sent_http_content_type 写法——直接在每个 location 里硬编码 expires 更稳妥。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











