我们来看一个使用示例,在该示例中,展示了资源管理在WebServer的静态服务、配置管理、模板引擎中的使用。

资源文件

资源文件源码:https://github.com/gogf/gf/tree/master/os/gres/testdata/example/files

资源文件打包:https://github.com/gogf/gf/tree/master/os/gres/testdata/example/boot

资源文件列表:

2020-03-28T13:04:10+00:00   0.00B config
2020-03-28T13:03:06+00:00 135.00B config/config.toml
2020-03-28T13:04:10+00:00   0.00B public
2020-03-28T12:57:54+00:00   6.00B public/index.html
2020-03-28T13:04:10+00:00   0.00B template
2020-03-28T13:03:17+00:00  15.00B template/index.tpl
TOTAL FILES: 6

三个文件的内容分别为:

  1. config.toml

     [server]
         Address    = ":8888"
         ServerRoot = "public"
    
     [viewer]
         DefaultFile = "index.tpl"
         Delimiters  = ["${", "}"]

    该文件为应用的配置文件。

  2. index.html

     Hello!

    该文件用于静态资源请求。

  3. index.tpl

     Hello ${.name}!

    该文件用于模板文件解析展示。

创建应用

package main

import (
	_ "github.com/gogf/gf/v2/os/gres/testdata/example/boot"

	"github.com/gogf/gf/v2/frame/g"
	"github.com/gogf/gf/v2/net/ghttp"
)

func main() {
	s := g.Server()
	s.Group("/", func(group *ghttp.RouterGroup) {
		group.GET("/template", func(r *ghttp.Request) {
			r.Response.WriteTplDefault(g.Map{
				"name": "GoFrame",
			})
		})
	})
	s.Run()
}

可以看到,整个代码中除了import中额外增加了一个 _ "github.com/gogf/gf/v2/os/gres/testdata/example/boot" 的包引入外,没有其他任何设置。这也是GoFrame框架的资源管理比较便捷的地方,资源管理并不需要开发阶段对代码做任何特殊设置,在应用程序部署之前打包好资源文件,并通过import增加资源文件的引入即可。

运行后,终端输出:

2020-03-28 21:36:19.828 75892: http server started listening on [:8888]

  SERVER  | DOMAIN  | ADDRESS | METHOD |   ROUTE   |      HANDLER      | MIDDLEWARE
|---------|---------|---------|--------|-----------|-------------------|------------|
  default | default | :8888   | GET    | /template | main.main.func1.1 |
|---------|---------|---------|--------|-----------|-------------------|------------|

可以看到,配置文件被自动读取并应用到了WebServer上。

我们通过curl命令测试一下静态文件以及模板引擎的访问。

$ curl http://127.0.0.1:8888/
Hello!

$ curl http://127.0.0.1:8888/template
Hello GoFrame!

可以看到,index.html静态文件以及index.tpl模板文件都被成功访问到了。



Content Menu

  • No labels

4 Comments

  1. 有没有办法让gf优先读取物理目录?如果物理目录不存在再读取打包的资源?

    这样某些静态文件就可以热更新了,譬如静态网页什么的,如果每次更新都得重新打包,某些场景下就不太方便了。

    1. 目前不支持,你可以给配置组件提个PR,增加检索策略控制。

      1. 还有这个config文件也当做资源打包进去是不是也不太合适,配置的字段需要根据运行环境修改

        1. 可以自行选择是否打入