Skip to main content
Version: 2.7.x(Latest)

GF(Go Frame) https://goframe.org 是一款模块化、高性能、生产级的Go基础开发框架。实现了比较完善的基础设施建设,包括常用的核心开发组件, 如:缓存、日志、文件、时间、队列、数组、集合、字符串、定时器、命令行、文件锁、内存锁、对象池、连接池、资源管理、数据校验、数据编码、文件监控、 定时任务、数据库ORM、TCP/UDP组件、进程管理/通信、并发安全容器等等。 并提供了Web服务开发的系列核心组件,如:Router、Cookie、Session、Middleware、服务注册、配置管理、模板引擎等等, 支持热重启、热更新、多域名、多端口、多服务、HTTPS、Rewrite等特性。

GoFrame 有着丰富的基础模块、完善的工具链、详尽的开发文档。开源近两年以来, GoFrame 得到越来越多小伙伴的肯定和支持,从寂寂无名到现在被广泛应用于微服务、物联网、区块链、电商系统、银行系统等企业级的生产项目中,经历了百万级、千万级项目的考验,2019年度被码云 gitee 评选为 GVP 最有价值开源项目。 GoFrame 正在快速地成长中,目前保持着1-2个月迭代版本的发布规律,社区活跃,欢迎加入 GoFrame 大家庭。

最后,祝大家2020新年快乐,鼠年大吉!

新特性

  1. 新年新气象,官网文档大量更新: https://goframe.org/index
  2. GoFrame 工具链更新: https://goframe.org/toolchain/cli
    • 新增 gf run 热编译运行命令;
    • 新增 gf docker Docker镜像编译命令;
    • 新增 gf gen model 强大的模型自动生成命令;
    • gf build 命令增加对配置文件配置支持;
    • 大量命令行工具改进工作;
    • 新增自动代理设置特性;
  3. 数据库 ORM 新特性:

功能改进

container

  1. garray
    • 新增 New*ArrayRange 方法,用于初始化创建指定数值范围的数组。
    • 新增 Iterator* 方法,用于数组项元素回调遍历。
    • 完善单元测试。
  2. gvar
    • 改进 MapStrStrMapStrStrDeep 方法实现。

net

  1. ghttp
    • 改进HTTP客户端,增加对提交参数的自动 Content-Type 识别功能。
    • Request 对象增加 Parse 方法,用于快捷的对象转换即参数校验。
    • Request.GetPost* 方法全部标记为 deprecated,统一客户端参数提交方式为 QueryString, Form, Body
    • 去掉 Response 模板解析时的 Get/ Post 内置变量,新增 Query, Form, Request 内置变量: https://goframe.org/net/ghttp/response/template
    • 改进 Response.WriteJson*Response.WriteXml* 方法,增加对 string, []byte 类型参数的支持。
    • Server 新增 GetRouterArray 方法,用于向应用层暴露并获取 Server 的路由列表。
    • Server 新增 Use 方法,该方法为 BindMiddlewareDefault 的别名,用以全局中间件的注册。
    • Server 新增 RouteOverWrite 配置项,用于控制是否在注册路由冲突时自动覆盖,默认关闭并提示。
    • Server 新增 Graceful 配置项,用于在单服务场景下控制平滑重启特性的开启/关闭,默认开启。
    • 完善单元测试。
  2. gtcp
    • 改进简单协议下的数据包发送接收功能。
    • 将连接池默认的缓存过期时间 30 秒修改为 10 秒。
    • 完善单元测试。

database

  1. gdb

    • 新增 As 数据表别名方法。

    • 改进数据表、字段的安全字符自动识别添加功能。

    • 新增 DB 数据库对象切换方法。

    • 新增 TX 链式操作事务支持方法。

    • 完善单元测试。

      os

  2. gcfg

    • 新增 GetMapStrStr 方法。
  3. gcmd

    • 增加参数解析的 strict 严格参数,默认严格解析,不存在指定参数/选项名称时则报错返回。
  4. genv

    • 改进 Remove 方法支持多个环境变量的删除。
  5. gfile

    • 改进 TempDir 临时目录获取方法,在 *nix 系统下默认为 /tmp 目录。
    • 新增 ReadLines, ReadByteLines 方法,用以按行回调读取文件内容。
    • 新增 Copy* 方法,用以文件/目录的拷贝,支持递归。
    • 新增 Replace* 方法,用以目录下的文件内容替换,支持递归。
    • 改进 Scan* 方法,用以检索并返回指定目录下的所有文件/目录,支持文件模式指定,支持递归。
    • 完善单元测试。
  6. gproc

    • 改进命令行运行方法。
    • 改进 Shell 命令文件检索逻辑。
    • 改进实验性的进程间通信设计。
  7. gtime

    • 将包方法以及 Time 对象的时间戳方法 Second, Millisecond, Microsecond, Nanosecond 标记为废除, 并新增 Timestamp, TimestampMilli, TimestampMicro, TimestampNano 替换。
    • 需要注意的是以上修改可能和老版本存在兼容性问题。
  8. gview

    • 解析功能、缓存设计改进。
    • 新增 encode, decode HTML编码/解码模板函数。
    • 新增 concat 字符串拼接模板函数。
    • 新增 dump 模板函数,功能类似于 g.Dump 方法。
    • 新增 AutoEncode 配置项,用于自动转码输出的 HTML 内容,常用于防止 XSS,默认关闭。需要注意的是该特性并不会影响 include 内置函数: https://goframe.org/os/gview/xss
    • 单元测试完善。

crypto

  1. gmd5
    • 增加 MustEncrypt, MustEncryptBytes, MustEncryptString, MustEncryptFile 方法。
  2. gsha1
    • 增加 MustEncryptFile 方法

encoding

  1. gbase64
    • 新增 MustEncodeFile, MustEncodeFileToString, MustDecode, MustDecodeToString 方法。
  2. gjson/ gparser
    • 新增 GetMapStrStr 方法。
    • 新增 Must* 方法,用于指定数据格式的转换失败时产生 panic 错误,而不会返回 error 参数。

util

  1. gconv
    • 改进 Convert 方法增加对 []int32, []int64, []uint, []uint32, []uint64, []float32, []float64 数据类型的转换支持。
    • 改进 String 字符串转换方法对指针参数的支持。
    • 改进 Map* Map转换方法的代码结构及性能。
    • 新增 Floats, Float32s, Float64s[]float32, []float64 类型转换方法。
    • 新增 Ints, Int32s, Int64s[]int, []int32, []int64 类型转换方法。
    • 新增 Uints, Uint32s, Uint64s[]uint, []uint32, []uint64 类型转换方法。
    • 完善单元测试。

frame

  1. gins
    • 所有的单例对象在获取失败时产生 panic 错误。

Bug Fix

  1. 增加对常见错误路由格式例如 /user//index 的兼容支持。
  2. 修复 gtcp/ gudp 在数据接收时的间隔时间单位问题。
  3. 修复 gfile/ gspath/ gfsnotify 包对文件的存在性判断不严谨问题。
  4. 修复 gproc.Kill 方法在 windows 系统下的运行阻塞问题。
  5. 修复 gstr.TrimLeftStr/ gstr.TrimRightStr 在被替换字符串长度小于替换字符串长度时的数组溢出问题。