在phpEnv集成的Nginx环境中，通过启用缓存分片功能，可以将大文件拆分为多个小片段进行缓存和传输，有效提升大文件的访问速度，减少带宽占用。这种方案特别适合本地开发中需要频繁访问大体积静态文件的场景。
缓存分片的工作原理
Nginx的缓存分片功能基于slice模块实现，它会将客户端请求的大文件按照指定大小拆分成多个片段，每个片段作为独立的缓存对象存储。当客户端请求文件时，Nginx会根据请求的范围返回对应的片段，而不是传输整个文件，同时未缓存的片段会被自动缓存到本地，后续请求相同片段时可以直接命中缓存。
phpEnv中Nginx配置步骤
1. 确认Nginx已编译slice模块
phpEnv自带的Nginx通常已经默认编译了ngx_http_slice_module模块，我们可以通过查看Nginx编译参数确认。打开phpEnv安装目录下的Nginx文件夹，进入命令行执行以下命令：
nginx -V 2>&1 | grep slice
如果输出中包含--with-http_slice_module，说明模块已启用，可以直接进行后续配置。
2. 修改Nginx站点配置
打开phpEnv的Nginx配置文件，通常路径为phpEnv安装目录/nginx/conf/vhost/你的站点.conf，在server块中添加缓存相关配置：
# 定义缓存路径和参数
proxy_cache_path D:/phpEnv/nginx/cache levels=1:2 keys_zone=file_cache:10m max_size=10g inactive=30d use_temp_path=off;
server {
listen 80;
server_name localhost;
root D:/phpEnv/www;
index index.html index.php;
# 大文件缓存分片配置
location ~* .(mp4|zip|iso|tar.gz|pdf)$ {
# 开启缓存分片，每个片段大小为1MB
slice 1m;
# 关联缓存区域
proxy_cache file_cache;
# 缓存键包含请求范围和文件路径，确保不同片段正确缓存
proxy_cache_key $uri$is_args$args$slice_range;
# 设置缓存有效期
proxy_cache_valid 200 30d;
proxy_cache_valid 206 30d;
# 传递范围请求头到后端
proxy_set_header Range $http_range;
# 设置后端返回的范围响应被缓存
proxy_http_version 1.1;
proxy_set_header Connection "";
# 如果缓存未命中，请求后端文件
proxy_pass http://127.0.0.1:8080;
# 添加缓存状态头方便调试
add_header X-Cache-Status $upstream_cache_status;
}
}
上述配置中，slice 1m表示将大文件拆分为每个1MB的片段，你可以根据实际需求调整这个大小，比如设置为2m或者512k。proxy_cache_path中的max_size是缓存总大小上限，inactive是缓存片段未访问的过期时间。
3. 重启Nginx生效配置
配置修改完成后，在phpEnv控制面板中重启Nginx服务，或者在命令行执行以下命令：
nginx -s reload
配置参数说明
| 参数 | 作用 |
|---|---|
| slice | 指定每个缓存分片的大小，支持的单位有k、m、g |
| proxy_cache_key | 定义缓存的键，必须包含$slice_range才能区分不同的文件片段 |
| proxy_cache_valid | 设置不同响应状态码的缓存有效期，206是范围请求的状态码 |
| proxy_set_header Range | 将客户端的Range请求头传递给后端，确保后端返回正确的文件片段 |
验证配置效果
配置生效后，访问站点中的大文件，比如http://localhost/test.zip，可以通过查看响应头中的X-Cache-Status判断缓存是否命中。首次访问时该值为MISS，再次访问相同片段时值为HIT，说明缓存分片已经正常工作。同时可以观察proxy_cache_path配置的缓存目录下是否生成了对应的缓存文件片段。
注意事项
- 缓存分片仅对支持范围请求的静态文件有效，动态生成的文件不建议使用此配置
- slice的大小需要根据文件平均大小调整，过小的分片会增加缓存管理开销，过大的分片则无法发挥分片的作用
- 如果后端是本地文件，也可以直接使用
root指令配合slice模块，不需要走proxy_pass，配置会更简单
如果不需要proxy_pass转发，本地静态文件的大文件缓存分片可以简化为以下配置：
location ~* .(mp4|zip|iso|tar.gz|pdf)$ {
slice 1m;
proxy_cache file_cache;
proxy_cache_key $uri$is_args$args$slice_range;
proxy_cache_valid 200 30d;
proxy_cache_valid 206 30d;
# 直接返回本地文件，配合slice模块实现分片
add_header X-Cache-Status $upstream_cache_status;
}