简体中文

English

简体中文

English

主题

辅助函数 ​

可用方法 ​

路径 ​

path.App()path.Base()path.Config()
path.Database()path.Storage()path.Public()

时间 ​

carbon.Now()carbon.SetTimezone()carbon.Parse()
carbon.FromTimestamp()carbon.FromDateTime()carbon.FromDate()
carbon.FromTime()carbon.FromStdTime()carbon.IsTestNow()
carbon.SetTestNow()carbon.UnsetTestNow()

调试 ​

debug.Dump()debug.SDump()debug.FDump()

映射 ​

maps.Add()maps.Exists()maps.Forget()
maps.Get()maps.Has()maps.HasAny()
maps.Only()maps.Pull()maps.Set()
maps.Where()

转换 ​

convert.Tap()convert.With()convert.Transform()
convert.Default()convert.Pointer()

收集 ​

collect.Count()collect.CountBy()collect.Each()
collect.Filter()collect.GroupBy()collect.Keys()
collect.Map()collect.Max()collect.Merge()
collect.Min()collect.Reverse()collect.Shuffle()
collect.Split()collect.Sum()collect.Unique()
collect.Values()

路径 ​

path.App() ​

path.App() 函数返回应用程序的 app 目录路径。 您还可以使用 path.App() 函数生成相对于应用程序目录的文件路径：

go
import "github.com/goravel/framework/support/path"

path := path.App()
path := path.App("http/controllers/controller.go")

path.Base() ​

path.Base() 函数返回应用程序根目录的路径。 您还可以使用 path.Base() 函数生成相对于项目根目录的给定文件路径：

go
path := path.Base()
path := path.Base("vendor/bin")

path.Config() ​

path.Config() 函数返回应用程序配置目录的路径。 您还可以使用 path.Config() 函数生成应用程序配置目录中给定文件的路径：

go
path := path.Config()
path := path.Config("app.go")

path.Database() ​

path.Database() 函数返回应用程序数据库目录的路径。 您还可以使用 path.Database() 函数生成 database 目录中给定文件的路径：

go
path := path.Database()
path := path.Database("factories/user_factory.go")

path.Storage() ​

path.Storage() 函数返回应用程序存储目录的路径。 您还可以使用 path.Storage() 函数生成 storage 目录中指定文件的路径：

go
path := path.Storage()
path := path.Storage("app/file.txt")

path.Public() ​

path.Public() 函数返回应用程序公共目录的路径。 您还可以使用 path.Public() 函数生成 public 目录中指定文件的路径：

go
path := path.Public()
path := path.Public("css/app.css")

path.Lang() ​

path.Lang() 函数返回 lang 目录的路径。 您还可以使用 path.Lang() 函数生成 lang 目录中指定文件的路径：

go
path := path.Lang()
path := path.Lang("en.json")

时间 ​

Goravel 的 carbon 模块是 golang-module/carbon 的扩展，主要特点是实现了时间回溯，详情请参考官方文档。

carbon.Now() ​

获取当前时间：

go
import "github.com/goravel/framework/support/carbon"

carbon.Now()

carbon.SetTimezone() ​

设置时区：

go
carbon.SetTimezone(carbon.UTC)

carbon.Parse() ​

通过字符串获取 Carbon 对象：

go
carbon.Parse("2020-08-05 13:14:15")

carbon.FromTimestamp() ​

通过时间戳获取 Carbon 对象：

go
carbon.FromTimestamp(1577836800)

carbon.FromDateTime() ​

通过日期时间获取 Carbon 对象：

go
carbon.FromDateTime(2020, 1, 1, 0, 0, 0)

carbon.FromDate() ​

通过日期获取 Carbon 对象：

go
carbon.FromDate(2020, 1, 1)

carbon.FromTime() ​

通过时间获取 Carbon 对象：

go
carbon.FromTime(0, 0, 0)

carbon.FromStdTime() ​

通过 time.Time 获取 Carbon 对象：

go
carbon.FromStdTime(time.Now())

carbon.IsTestNow() ​

判断时间是否为测试值：

go
carbon.IsTestNow()

carbon.SetTestNow() ​

将时间设置为测试值：

go
carbon.SetTestNow(carbon.Now())

carbon.UnsetTestNow() ​

将时间恢复为正常值：

go
carbon.UnsetTestNow()

调试 ​

debug.Dump() ​

debug.Dump() 可以打印任何变量：

go
import "github.com/goravel/framework/support/debug"

debug.Dump(myVar1, myVar2, ...)

debug.FDump() ​

debug.FDump() 可以将任何变量打印到 io.Writer：

go
import "github.com/goravel/framework/support/debug"

debug.FDump(someWriter, myVar1, myVar2, ...)

debug.SDump() ​

debug.SDump() 可以将任何变量打印为 string：

go
import "github.com/goravel/framework/support/debug"

debug.SDump(myVar1, myVar2, ...)

映射 ​

maps.Add() ​

maps.Add() 函数在给定的 map 中添加一个新的键值对，如果该键在 map 中不存在：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Krishan"}
maps.Add(mp, "age", 22)
// map[string]any{"name": "Krishan", "age": 22}

mp2 := map[string]string{}
maps.Add(mp2, "name", "Bowen")
maps.Add(mp2, "name", "Krishan")
// map[string]string{"name": "Bowen"}

maps.Exists() ​

maps.Exists() 函数用于确定给定的键是否存在于提供的映射中：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Krishan", "age": 22}

exists := maps.Exists(mp, "name") // true

exists = maps.Exists(mp, "email") // false

maps.Forget() ​

maps.Forget() 函数从提供的映射中移除给定的键（s）：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]string{"name": "Krishan", "age": "22"}

maps.Forget(mp, "name", "age")
// map[string]string{}

maps.Get() ​

函数 maps.Get() 从提供的映射中检索给定键的值。 如果键不存在，将 返回默认值：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Bowen"}

value := maps.Get(mp, "name", "Krishan")
// Bowen

value = maps.Get(mp, "age", 22)
// 22

maps.Has() ​

函数 maps.Has() 用于确定给定的键是否存在于提供的映射中：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Goravel", "language": "Go"}

exists := maps.Has(mp, "name", "language")
// true

exists = maps.Has(mp, "name", "age")
// false

maps.HasAny() ​

函数 maps.HasAny() 用于确定给定的任何键是否存在于提供的映射中：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Goravel", "language": "Go"}

exists := maps.HasAny(mp, "name", "age")
// true

exists = maps.HasAny(mp, "age", "email")
// false

maps.Only() ​

maps.Only() 函数从提供的映射中仅检索给定的键：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Goravel", "language": "Go"}

newMap := maps.Only(mp, "name")
// map[string]any{"name": "Goravel"}

newMap = maps.Only(mp, "name", "age")
// map[string]any{"name": "Goravel"}

maps.Pull() ​

maps.Pull() 函数从提供的映射中检索并移除给定的键：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Goravel", "language": "Go"}

name := maps.Pull(mp, "name")
// name = "Goravel"
// mp = map[string]any{"language": "Go"}

可以为 maps.Pull() 函数提供第三个参数作为默认值。 如果键在映射中不存在，将返回此值：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Goravel", "language": "Go"}

name := maps.Pull(mp, "age", "default")
// name = "default"
// mp = map[string]any{"name": "Goravel", "language": "Go"}

maps.Set() ​

maps.Set() 函数在提供的映射中设置给定的键和值：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]any{"name": "Goravel"}

maps.Set(mp, "language", "Go")
// map[string]any{"name": "Goravel", "language": "Go"}

maps.Where() ​

maps.Where() 函数使用给定的回调函数过滤提供的映射：

go
import "github.com/goravel/framework/support/maps"

mp := map[string]string{"name": "Goravel", "language": "Go"}

newMap := maps.Where(mp, func(key string, value string) bool {
    return key == "name"
})
// map[string]string{"name": "Goravel"}

转换 ​

convert.Tap() ​

convert.Tap() 函数将给定值传递给提供的回调函数并返回该值：

go
import "github.com/goravel/framework/support/convert"

value := convert.Tap("Goravel", func(value string) {
    fmt.Println(value + " Framework")
})
// Goravel

mp := map[string]string{"name": "Goravel"}
val := convert.Tap(mp, func(value map[string]string) {
    mp["language"] = "Go"
})
// map[string]string{"name": "Goravel", "language": "Go"}

convert.Transform() ​

convert.Transform() 使用提供的回调函数转换给定值并返回结果：

go
import "github.com/goravel/framework/support/convert"

value := convert.Transform(1, strconv.Itoa)
// "1"

val := convert.Transform("foo", func(s string) *foo {
      return &foo{Name: s}
})
// &foo{Name: "foo"}

convert.With() ​

convert.With() 使用提供的值执行给定的回调并返回回调的结果：

go
import "github.com/goravel/framework/support/convert"

value := convert.With("Goravel", func(value string) string {
    return value + " Framework"
})
// Goravel Framework

convert.Default() ​

convert.Default() 方法返回第一个非零值。 如果所有值都为零，则返回零值。

go
import "github.com/goravel/framework/support/convert"

value := convert.Default("", "foo")
// foo

value = convert.Default("bar", "foo")
// bar

value = convert.Default(0, 1)
// 1

convert.Pointer() ​

方法 convert.Pointer() 返回给定值的指针。

go
import "github.com/goravel/framework/support/convert"

convert.Pointer("foo") // *string("foo")

convert.Pointer(1) // *int(1)

收集 ​

collect.Count() ​

函数 collect.Count() 返回给定集合中的项目数量：

go
import "github.com/goravel/framework/support/collect"

collect.Count([]string{"Goravel", "Framework"})
// 2

collect.CountBy() ​

函数 collect.CountBy() 计算谓词为真的出现次数：

go
import "github.com/goravel/framework/support/collect"

collect.CountBy([]string{"Goravel", "Framework"}, func(value string) bool {
    return strings.Contains(value, "Goravel")
})
// 1

collect.Each() ​

函数 collect.Each() 遍历给定集合中的项目，并将每个项目传递给给定的回调函数：

go
import "github.com/goravel/framework/support/collect"

collect.Each([]string{"Goravel", "Framework"}, func(value string, index int) {
    fmt.Println(index + 1, value)
})
// 1 Goravel
// 2 Framework

collect.Filter() ​

函数 collect.Filter() 使用给定的回调函数过滤集合中的项目：

go
import "github.com/goravel/framework/support/collect"

newCollection := collect.Filter([]string{"Goravel", "Framework"}, func(value string) bool {
    return strings.Contains(value, "Goravel")
})

// []string{"Goravel"}

collect.GroupBy() ​

函数 collect.GroupBy() 根据给定回调函数的结果对集合中的项目进行分组：

go
import "github.com/goravel/framework/support/collect"

// 复杂映射切片的使用示例（使用不同的示例）
newCollection := collect.GroupBy([]map[string]string{
    {"class": "1", "Name": "Rohan"},
    {"class": "2", "Name": "Bowen"},
    {"class": "2", "Name": "Krishan"},
}, func(value map[string]string) string {
    return value["class"]
})

// map[string][]map[string]string{
//     "1": []map[string]string{{"class": "1", "Name": "Rohan"}},
//     "2": []map[string]string{{"class": "2", "Name": "Bowen"}, {"class": "2", "Name": "Krishan"}},
// }

collect.Keys() ​

collect.Keys() 函数返回集合中所有项目的键：

go
import "github.com/goravel/framework/support/collect"

keys := collect.Keys(map[string]string{"name": "Goravel", "language": "Go"})
// []string{"name", "language"}

collect.Map() ​

collect.Map() 函数使用给定的迭代器将一种类型的集合转换为另一种类型：

go
import "github.com/goravel/framework/support/collect"

newCollection := collect.Map([]string{"Goravel", "Framework"}, func(value string,  _ int) string {
    return strings.ToUpper(value)
})

// []string{"GORAVEL", "FRAMEWORK"}

collect.Max() ​

collect.Max() 函数返回给定集合的最大值：

go
import "github.com/goravel/framework/support/collect"

max := collect.Max([]int{1, 2, 3, 4, 5})
// 5

collect.Merge() ​

collect.Merge() 函数将给定的多个映射合并成一个单一的映射：

go
import "github.com/goravel/framework/support/collect"

newMap := collect.Merge(map[string]string{"name": "Goravel"}, map[string]string{"language": "Go"})
// map[string]string{"name": "Goravel", "language": "Go"}

newMap = collect.Merge(map[string]string{"name": "Goravel"}, map[string]string{"name": "Framework"})
// map[string]string{"name": "Framework"}

collect.Min() ​

函数 collect.Min() 返回给定集合中的最小值：

go
import "github.com/goravel/framework/support/collect"

min := collect.Min([]int{1, 2, 3, 4, 5})
// 1

collect.Reverse() ​

函数 collect.Reverse() 反转集合中的项目：

go
import "github.com/goravel/framework/support/collect"

newCollection := collect.Reverse([]string{"Goravel", "Framework"})

// []string{"Framework", "Goravel"}

collect.Shuffle() ​

函数 collect.Shuffle() 打乱集合中的项目：

go
import "github.com/goravel/framework/support/collect"

newCollection := collect.Shuffle([]int{1, 2, 3, 4, 5})

// []int{3, 1, 5, 2, 4}(示例)

collect.Split() ​

函数 collect.Split() 将集合分割成给定长度的组。 如果集合无法被平均分割，最后一个块将包含剩余的项目：

go
import "github.com/goravel/framework/support/collect"

newCollection := collect.Split([]int{1, 2, 3, 4, 5}, 2)

// [][]int{{1, 2}, {3, 4}, {5}}

collect.Sum() ​

collect.Sum() 函数返回集合中所有项目的总和：

go

import "github.com/goravel/framework/support/collect"

sum := collect.Sum([]int{1, 2, 3, 4, 5})

// 15

collect.Unique() ​

collect.Unique() 方法返回去重后的集合，对于重复值，只保留第一次出现的值：

go
import "github.com/goravel/framework/support/collect"

newCollection := collect.Unique([]string{"Goravel", "Framework", "Goravel"})

// []string{"Goravel", "Framework"}

collect.Values() ​

函数 collect.Values() 返回给定集合的所有值：

go
import "github.com/goravel/framework/support/collect"

values := collect.Values(map[string]string{"name": "Goravel", "language": "Go"})
// []string{"Goravel", "Go"}

基于 MIT 许可发布

版权所有 © 2021-2025 Goravel