GoFrame入门教程 GoFrame Session-File

2024-02-25 开发教程 GoFrame入门教程匿名 3℃

文件存储

在默认情况下，ghttp.Server的Session存储使用了内存+文件的方式，使用StorageFile对象实现。具体原理为：

Session的数据操作完全基于内存；
使用gcache进程缓存模块控制数据过期；
使用文件存储持久化存储管理Session数据；
当且仅有当Session被标记为dirty时（数据有更新）才会执行Session序列化并执行文件持久化存储；
当且仅当内存中的Session不存在时，才会从文件存储中反序列化恢复Session数据到内存中，降低IO调用；
序列化/反序列化使用的是标准库的json.Marshal/UnMarshal方法；

从原理可知，当Session为读多写少的场景中，Session的数据操作非常高效。

有个注意的细节，由于文件存储涉及到文件操作，为便于降低IO开销并提高Session操作性能，并不是每一次Session请求结束后都会立即刷新对应Session的TTL时间。而只有当涉及到更新操作（被标记为dirty）时才会立即刷新其TTL；针对于读取请求，将会每隔一分钟更新前一分钟内读取操作对应的Session文件TTL时间，以便于Session自动续活。

使用示例

package main
import (
	"github.com/gogf/gf/v2/frame/g"
	"github.com/gogf/gf/v2/net/ghttp"
	"github.com/gogf/gf/v2/os/gtime"
	"time"
)
func main() {
	s := g.Server()
	s.SetConfigWithMap(g.Map{
		"SessionMaxAge": time.Minute,
	})
	s.Group("/", func(group *ghttp.RouterGroup) {
		group.ALL("/set", func(r *ghttp.Request) {
			r.Session.Set("time", gtime.Timestamp())
			r.Response.Write("ok")
		})
		group.ALL("/get", func(r *ghttp.Request) {
			r.Response.Write(r.Session.Map())
		})
		group.ALL("/del", func(r *ghttp.Request) {
			r.Session.Clear()
			r.Response.Write("ok")
		})
	})
	s.SetPort(8199)
	s.Run()
}

在该实例中，为了方便观察过期失效，我们将Session的过期时间设置为1分钟。执行后，

首先，访问 http://127.0.0.1:8199/set设置一个Session变量；
随后，访问 http://127.0.0.1:8199/get可以看到该Session变量已经设置并成功获取；
接着，我们停止程序，并重新启动，再次访问 http://127.0.0.1:8199/get，可以看到Session变量已经从文件存储中恢复；
等待1分钟后，再次访问 http://127.0.0.1:8199/get可以看到已经无法获取该Session，因为该Session已经过期；

上一节： GoFrame Session-基本介绍

下一节： GoFrame Session-Memory

"GoFrame入门教程"的目录

GoFrame入门教程 GoFrame Session-File

文件存储

使用示例