从 v1.13 升级到 v1.14
令人兴奋的新功能 🎉
功能增强 🚀
- gin 和 fiber 驱动支持设置 body_limit 和 header_limit
- Log 新增方法
- Orm 新增方法
- Console 新增方法
- Response 新增方法
- 新增 Build 命令
- 新增 helper 方法
- Redis 驱动支持设置 TLS
破坏性变化 🛠
- Validation 如果验证失败将不绑定数据
- Testing 模块新增、修改方法
- 优化 Mail 模块的 Queue 方法
- 优化 Auth 模块 ctx 的设置方法
- 优化 mock facades 的方式
- 框架 Orm model 新增 json tag
v1.14.1
v1.14.2
v1.14.3
同时升级：goravel/gin: v1.2.2, goravel/fiber: v1.2.2
v1.14.4
同时升级：goravel/gin: v1.2.3
v1.14.5
同时升级：goravel/gin: v1.2.4, goravel/fiber: v1.2.3
v1.14.7
同时升级：goravel/gin: v1.2.5, goravel/fiber: v1.2.4
v1.14.8
v1.14.9
升级指南
Goravel v1.14 基于 Golang 1.21 进行开发与测试，与其他低 Golang 版本一般情况下可以兼容运行。 请根据本节内容，一步步进行框架升级。
预计升级时间：10 分钟
1. 更新依赖
go get -u github.com/goravel/framework@v1.14.7
// 如果使用 gin
go get -u github.com/goravel/gin@v1.2.5
// 如果使用 fiber
go get -u github.com/goravel/fiber@v1.2.4
// 如果使用 redis
go get -u github.com/goravel/redis@v1.2.1
// 如果使用 s3
go get -u github.com/goravel/s3@v1.2.0
// 如果使用 oss
go get -u github.com/goravel/oss@v1.2.0
// 如果使用 cos
go get -u github.com/goravel/cos@v1.2.0
// 如果使用 minio
go get -u github.com/goravel/minio@v1.2.0
// 如果使用 cloudinay
go get -u github.com/goravel/cloudinary@v1.2.0
go mod tidy2. 新增配置项
config/app.go新增本地化模块配置项：
"locale": "en",
"fallback_locale": "en",
"providers": []foundation.ServiceProvider{
...
&session.ServiceProvider{},
&translation.ServiceProvider{},
...
}- 如果需要使用
session功能，新增 config/session.go 文件；
3) 如果正在使用 Validation 模块
检查是否在校验数据失败的情况下依然尝试读取绑定值。 如果有，需优化逻辑，因为该值升级后为空。 详见：Validation 如果验证失败将不绑定数据。
4. 如果正在使用 Testing 模块
检查是否使用 Clear, Image 方法，如果有，需相应修改：Testing 模块新增、修改方法
5. 如果正在使用 Mail 模块
检查是否使用 Queue 方法，如果有，需相应修改：优化 Mail 模块的 Queue 方法
6. 如果正在使用 Auth 模块
需相应修改：优化 Auth 模块 ctx 的设置方法
7. 如果正在使用 mock facades
需相应修改：优化 mock facades 的方式
8. 如果正在使用框架 Orm model 并且直接通过接口返回数据
需相应修改：框架 Orm model 新增 json tag
功能介绍
本地化
Version: v1.14.0
安装器
Version: v1.14.0
通过安装器，你可以很方便的下载并初始化一个新的 Goravel 项目。
Cookie
Version: v1.14.0
Session
Version: v1.14.0
gin 和 fiber 驱动支持设置 body_limit 和 header_limit
Version: v1.14.0
HTTP 驱动支持设置 body_limit 和 header_limit 以限制 body, header 大小，详见：goravel/gin 和 goravel/fiber。
Log 新增方法
Version: v1.14.0
| 方法 | 描述 |
|---|---|
Stack | 同时使用多个日志通道 |
Channel | 指定日志通道 |
WithTrace | 打印堆栈信息 |
Orm 新增方法
Version: v1.14.0
新增 WhereIn, OrWhereIn, OrWhereNotIn, WhereNotIn, WhereBetween, WhereNotBetween, WhereNull, OrWhereNull, OrderByDesc, OrderBy, InRandomOrder, Exists 方法。
Console 新增方法
Version: v1.14.0
Response 新增方法
Version: v1.14.0
新增 Build 命令
Version: v1.14.0
Goravel 项目可以直接通过 go run . artisan build 命令进行编译。
新增 helper 方法
Version: v1.14.0
Redis 驱动支持设置 TLS
Version: v1.14.0
Validation 如果验证失败将不绑定数据
Version: v1.14.0
之前在调用下面方式时，如果验证失败 userRequest 依然绑定了值。 升级后则不再绑定。
var userRequest requests.UserRequest
errors, err := ctx.Request().ValidateRequest(&userRequest)
// or
validator, err := validation.Make(***)
err = validator.Bind(&userRequest)Testing 模块新增、修改方法
Version: v1.14.0
database, err := facades.Testing().Docker().Database()
database.Image(testingcontract.Image{
Repository: "mysql",
Tag: "5.7",
Env: []string{
"MYSQL_ROOT_PASSWORD=123123",
"MYSQL_DATABASE=goravel",
},
-- Timeout: 1000,
++ ExposedPorts: []string{"3306"},
})优化 Mail 模块的 Queue 方法
Version: v1.14.0
Queue 方法的入参由 queue *mail.Queue 改为 queue ...mail.Queue。
-- facades.Mail().Queue(nil)
++ facades.Mail().Queue()
-- facades.Mail().Queue(&mail.Queue{})
++ facades.Mail().Queue(mail.Queue{})优化 Auth 模块 ctx 的设置方法
Version: v1.14.0
之前调用 Parse, User, Login, LoginUsingID, Refresh, Logout 方法时，需要传递 ctx。 升级后不再需要，而是可以直接设置在 facades.Auth(ctx)。
-- facades.Auth().Parse(ctx, token)
++ facades.Auth(ctx).Parse(token)
-- facades.Auth().User(ctx, &user)
++ facades.Auth(ctx).User(&user)
-- facades.Auth().Login(ctx, &user)
++ facades.Auth(ctx).Login(&user)
-- facades.Auth().LoginUsingID(ctx, id)
++ facades.Auth(ctx).LoginUsingID(id)
-- facades.Auth().Refresh(ctx)
++ facades.Auth(ctx).Refresh()
-- facades.Auth().Logout(ctx)
++ facades.Auth(ctx).Logout()优化 mock facades 的方式
Version: v1.14.0
import github.com/goravel/framework/testing/mock
++ mockFactory := mock.Factory()
-- app := mock.App()
++ app := mockFactory.App()
-- artisan := mock.Artisan()
++ artisan := mockFactory.Artisan()
-- auth := mock.Auth()
++ auth := mockFactory.Auth()
-- artisan := mock.Artisan()
++ artisan := mockFactory.Artisan()
-- cache, driver, lock := mock.Cache()
++ cache := mockFactory.Cache()
++ driver := mockFactory.CacheDriver()
++ lock := mockFactory.CacheLock()
-- config := mock.Config()
++ config := mockFactory.Config()
-- crypt := mock.Crypt()
++ crypt := mockFactory.Crypt()
-- event, task := mock.Event()
++ event := mockFactory.Event()
++ event := mockFactory.EventTask()
-- gate := mock.Gate()
++ gate := mockFactory.Gate()
-- grpc := mock.Grpc()
++ grpc := mockFactory.Grpc()
-- hash := mock.Hash()
++ hash := mockFactory.Hash()
-- mock.Log()
++ mockFactory.Log()
-- mail := mock.Mail()
++ mail := mockFactory.Mail()
-- orm, query, transaction, association := mock.Orm()
++ orm := mockFactory.Orm()
++ query := mockFactory.OrmQuery()
++ transaction := mockFactory.OrmTransaction()
++ association := mockFactory.OrmAssociation()
-- queue, task := mock.Queue()
++ queue := mockFactory.Queue()
++ task := mockFactory.QueueTask()
-- rateLimiter := mock.RateLimiter()
++ rateLimiter := mockFactory.RateLimiter()
-- storage, driver, file := mock.Storage()
++ storage := mockFactory.Storage()
++ driver := mockFactory.StorageDriver()
++ file := mockFactory.StorageFile()
-- seeder := mock.Seeder()
++ seeder := mockFactory.Seeder()
-- validation, validator, errors := mock.Validation()
++ validation := mockFactory.Validation()
++ validator := mockFactory.ValidationValidator()
++ errors := mockFactory.ValidationErrors()
-- view := mock.View()
++ view := mockFactory.View()框架 Orm model 新增 json tag
Version: v1.14.0
如果使用了框架的 Orm model 并且通过接口直接返回数据，需要自己根据原 model 结构新建 model 并替换，或者前端根据 json tag 修改字段名称。
type Model struct {
-- ID uint `gorm:"primaryKey"`
++ ID uint `gorm:"primaryKey" json:"id"`
Timestamps
}
type SoftDeletes struct {
-- DeletedAt gorm.DeletedAt `gorm:"column:deleted_at"`
++ DeletedAt gorm.DeletedAt `gorm:"column:deleted_at" json:"deleted_at"`
}
type Timestamps struct {
-- CreatedAt carbon.DateTime `gorm:"autoCreateTime;column:created_at"`
-- UpdatedAt carbon.DateTime `gorm:"autoUpdateTime;column:updated_at"`
++ CreatedAt carbon.DateTime `gorm:"autoCreateTime;column:created_at" json:"created_at"`
++ UpdatedAt carbon.DateTime `gorm:"autoUpdateTime;column:updated_at" json:"updated_at"`
}修复 session 在 gin 驱动中设置不成功的问题
goravel/framework: v1.14.1
修复本地化模块中语言文件读取错误的问题
goravel/framework: v1.14.1
修复 Validation 验证 image 与 file 失败的问题
goravel/framework: v1.14.2
goravel/gin: v1.2.2
goravel/fiber: v1.2.2
修复 goravel/gin 驱动设置 cookie Expires 无效的问题
goravel/gin: v1.2.2
修复 Validation 无法绑定 slice 的问题
goravel/framework: v1.14.3
type User struct {
Tags []string `form:"tags" json:"tags"`
}Validation 支持绑定 carbon
goravel/framework: v1.14.3
// 定义 carbon 字段
type User struct {
Date carbon.Carbon `form:"date" json:"date"`
}
var user requests.User
// 使用 ValidateRequest 绑定数据
errors, err := ctx.Request().ValidateRequest(&user)
// 或使用 Validate 绑定数据
validator, err := ctx.Request().Validate(map[string]string{
"date": "required|date",
})
err := validator.Bind(&user)
// 获取时间
user.Date.ToDateTimeString()修复 Session 并发问题
goravel/framework: v1.14.4
当 Session 并发过高时，可能会出现 Session 读写冲突的问题。
修复 Gin 设置 Session same_site 无效的问题
goravel/gin: v1.2.3
Route 新增 Shutdown 方法
goravel/framework: v1.14.5
goravel/gin: v1.2.4
goravel/fiber: v1.2.3
优化 HTTP 的 ctx.WithValue 方法
goravel/framework: v1.14.7
goravel/gin: v1.2.5
goravel/fiber: v1.2.4
ctx.WithValue 方法的 key 由仅支持 string 类型，改支持 any 类型。
ctx.WithValue("Hello", "world")
ctx.WithValue(1, "hi")
var key struct{}
ctx.WithValue(key, "hola")修复注册 listener 冲突的问题
goravel/framework: v1.14.8
当多个 event 使用相同的 listener，注册时会提示 listener 冲突。
修复自定义 Log 驱动控制台重复打印的问题
goravel/framework: v1.14.9
修复 HTTP JSON Request 包含多层结构时数据绑定错误的问题
goravel/framework: v1.14.9