Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
静态文件服务配置
默认情况下，
...
GoFrame Server关闭了静态文件服务的功能，如果开发者配置了静态文件目录，那么静态文件服务将会自动开启。
静态文件服务涉及到的常用配置方法如下：
| Code Block | ||
|---|---|---|
| ||
// 设置http server参数 - ServerRoot
func (s *Server) SetServerRoot(root string)
// 添加静态文件搜索目录，必须给定目录的绝对路径
func (s *Server) AddSearchPath(path string)
// 设置http server参数 - IndexFiles，默认展示文件，如：index.html, index.htm
func (s *Server) SetIndexFiles(index []string)
// 是否允许展示访问目录的文件列表
func (s *Server) SetIndexFolder(enabled bool)
// 添加URI与静态目录的映射
func (s *Server) AddStaticPath(prefix string, path string)
// 静态文件服务总开关：是否开启/关闭静态文件服务
func (s *Server) SetFileServerEnabled(enabled bool)
// 设置URI重写规则
func (s *Server) SetRewrite(uri string, rewrite string)
// 设置URI重写规则（批量）
func (s *Server) SetRewriteMap(rewrites map[string]string) |
...
简要介绍：
...
IndexFiles为当访问目录时默认检索的文件名称列表（按照slice先后顺序进行检索），当检索的文件存在时则返回文件内容，否则展示目录列表(SetIndexFolder为true时)，默认的IndexFiles为：index.html, index.htm；
...
SetIndexFolder为设置是否在用户访问文件目录，且没有在目录下检索到IndexFiles时，则展示目录下的文件列表，默认为关闭；
...
SetServerRoot为设置默认提供服务的静态文件目录，该目录会被自动添加到SearchPath中的第一个搜索路径；
...
AddSearchPath为添加静态文件检索目录，可以有多个，按照文件目录添加的先后顺序执行优先级检索；
...
AddStaticPath为添加URI与目录路径的映射关系，可以自定义静态文件目录的访问URI规则；
...
SetRewrite/SetRewriteMap为重写规则设置（类似于nginx的rewrite），严格上来讲不仅仅是静态文件服务，当然也支持动态的路由注册的rewrite；
...
| Tip |
|---|
设置静态文件服务的目录路径时，可以使用绝对路径，也可以使用相对路径，例如设置当前运行目录提供静态文件服务可以使用 开发者可以设置多个文件目录来提供静态文件服务，并且可以设置目录及URI的优先级，但是一旦通过 |
示例1， 基本使用
| Code Block | ||
|---|---|---|
| ||
package main import "github.com/gogf/gf/v2/frame/g" // 静态文件服务器基本使用 func main() { s := g.Server() s.SetIndexFolder(true) s.SetServerRoot("/Users/john/Temp") s.AddSearchPath("/Users/john/Documents") s.SetPort(8199) s.Run() } |
...
示例2，静态目录映射
| Code Block | ||
|---|---|---|
| ||
package main import "github.com/gogf/gf/v2/frame/g" // 静态文件服务器，支持自定义静态目录映射 func main() { s := g.Server() s.SetIndexFolder(true) s.SetServerRoot("/Users/john/Temp") s.AddSearchPath("/Users/john/Documents") s.AddStaticPath("/my-doc", "/Users/john/Documents") s.SetPort(8199) s.Run() } |
...
示例3，静态目录映射，优先级控制
静态目录映射的优先级按照绑定的URI精准度进行控制，绑定的URI越精准（深度优先匹配），那么优先级越高。
| Code Block | ||
|---|---|---|
| ||
package main import "github.com/gogf/gf/v2/frame/g" // 静态文件服务器，支持自定义静态目录映射 func main() { s := g.Server() s.SetIndexFolder(true) s.SetServerRoot("/Users/john/Temp") s.AddSearchPath("/Users/john/Documents") s.AddStaticPath("/my-doc", "/Users/john/Documents") s.AddStaticPath("/my-doc/test", "/Users/john/Temp") s.SetPort(8199) s.Run() } |
...
其中，访问/my-doc/test的优先级会比/my-doc高，因此假如/Users/john/Documents目录下存在test目录（与自定义的/my-doc/test冲突），将会无法被访问到。
...
示例4，URI重写
...
GoFrame框架的静态文件服务支持将任意的URI重写，替换为制定的URI，使用SetRewrite/SetRewriteMap方法。
示例，在/Users/john/Temp目录下只有两个文件test1.html及test2.html。
| Code Block |
|---|
package main import "github.com/gogf/gf/v2/frame/g" func main() { |
...
s := g.Server() |
...
s.SetServerRoot("/Users/john/Temp") |
...
s.SetRewrite("/test.html", "/test1.html") |
...
s.SetRewriteMap(g.MapStrStr{ |
...
"/my-test1" |
...
: "/test1.html",
|
...
"/my-test2" |
...
: "/test2.html",
|
...
}) |
...
s.SetPort(8199) |
...
s.Run() } |
...
执行后，
...
- 当我们访问
/test.html，其实最终被重写到了test1.html，返回的是该文件内容；
...
- 当我们访问
/my-test1，其实最终被重写到了test1.html，返回的是该文件内容；
...
- 当我们访问
/my-test2，其实最终被重写到了test2.html，返回的是该文件内容；
示例5，跨域
| Code Block | ||
|---|---|---|
| ||
package main
import (
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/net/ghttp"
"github.com/gogf/gf/v2/os/glog"
)
func beforeServeHook(r *ghttp.Request) {
glog.Debugf(r.GetCtx(), "beforeServeHook [is file:%v] URI:%s", r.IsFileRequest(), r.RequestURI)
r.Response.CORSDefault()
}
// 利用hook注入跨域配置
func main() {
s := g.Server()
s.BindHookHandler("/*", ghttp.HookBeforeServe, beforeServeHook)
s.SetServerRoot(".")
s.SetFileServerEnabled(true)
s.SetAddr(":8080")
s.Run()
} |
| Panel | ||
|---|---|---|
| ||
|