[[toc]]
| path.App() | path.Base() | path.Config() |
| path.Database() | path.Storage() | path.Public() |
| 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() |
import "github.com/goravel/framework/support/path"The path.App() function returns the path to your application's app directory. You may also use the path.App() function to generate a path to a file relative to the application directory:
path := path.App()
path := path.App("http/controllers/controller.go")The path.Base() function returns the path to your application's root directory. You may also use the path.Base() function to generate a path to a given file relative to the project root directory:
path := path.Base()
path := path.Base("vendor/bin")The path.Config() function returns the path to your application's config directory. You may also use the path.Config() function to generate a path to a given file within the application's configuration directory:
path := path.Config()
path := path.Config("app.go")The path.Database() function returns the path to your application's database directory. You may also use the path.Database() function to generate a path to a given file within the database directory:
path := path.Database()
path := path.Database("factories/user_factory.go")The path.Storage() function returns the path to your application's storage directory. You may also use the path.Storage() function to generate a path to a given file within the storage directory:
path := path.Storage()
path := path.Storage("app/file.txt")The path.Public() function returns the path to your application's public directory. You may also use the path.Public() function to generate a path to a given file within the public directory:
path := path.Public()
path := path.Public("css/app.css")The path.Lang() function returns the path to the lang directory. You may also use the path.Lang() function to generate a path to a given file within the lang directory:
path := path.Lang()
path := path.Lang("en.json")The carbon module of Goravel is an expansion by dromara/carbon, please refer to the official documentation for details.
import "github.com/goravel/framework/support/carbon"The carbon.Now() function gets current time:
carbon.Now()The carbon.SetTimezone() function sets timezone：
carbon.SetTimezone(carbon.UTC)The carbon.SetLocale() function sets language locale, refer to locales list for all supported locales：
carbon.SetLocale("en")The carbon.SetTestNow() function sets the time to a test value:
carbon.SetTestNow(carbon.Now())The carbon.CleanTestNow() function clears the test now Carbon object:
carbon.CleanTestNow()The carbon.IsTestNow() function determines whether the time is a test value:
carbon.IsTestNow()The carbon.Parse() function gets Carbon object by String:
carbon.Parse("2020-08-05 13:14:15")The carbon.ParseByLayout() function gets Carbon object by given value and layout:
carbon.ParseByLayout("2020-08-05 13:14:15", carbon.DateTimeLayout)
carbon.ParseByLayout("2020|08|05 13|14|15", []string{"2006|01|02 15|04|05", "2006|1|2 3|4|5"})The carbon.ParseByFormat() function gets Carbon object by given value and format:
carbon.ParseByFormat("2020-08-05 13:14:15", carbon.DateTimeFormat)
carbon.ParseByFormat("2020|08|05 13|14|15", []string{"Y|m|d H|i|s", "y|m|d h|i|s"})The carbon.FromTimestamp() function gets Carbon object by timestamp with second precision:
carbon.FromTimestamp(1577836800)The carbon.FromTimestampMilli() function gets Carbon object by timestamp with millisecond precision:
carbon.FromTimestampMilli(1649735755999)The carbon.FromTimestampMicro() function gets Carbon object by timestamp with microsecond precision:
carbon.FromTimestampMicro(1649735755999999)The carbon.FromTimestampNano() function gets Carbon object by timestamp with nanosecond precision:
carbon.FromTimestampNano(1649735755999999999)The carbon.FromDateTime() function gets Carbon object by year, month, day, hour, minute, second:
carbon.FromDateTime(2020, 1, 1, 0, 0, 0)The carbon.FromDateTimeMilli() function gets Carbon object by year, month, day, hour, minute, second, millisecond:
carbon.FromDateTimeMilli(2020, 1, 1, 0, 0, 0, 999)The carbon.FromDateTimeMicro() function gets Carbon object by year, month, day, hour, minute, second, microsecond:
carbon.FromDateTimeMicro(2020, 1, 1, 0, 0, 0, 999999)The carbon.FromDateTimeNano() function gets Carbon object by year, month, day, hour, minute, second, nanosecond:
carbon.FromDateTimeNano(2020, 1, 1, 0, 0, 0, 999999999)The carbon.FromDate() function gets Carbon object by year, month, day:
carbon.FromDate(2020, 1, 1)The carbon.FromDateMilli() function gets Carbon object by year, month, day, millisecond:
carbon.FromDateMilli(2020, 1, 1, 999)The carbon.FromDateMicro() function gets Carbon object by year, month, day, microsecond:
carbon.FromDateMicro(2020, 1, 1, 999999)The carbon.FromDateNano() function gets Carbon object by year, month, day, nanosecond:
carbon.FromDateNano(2020, 1, 1, 999999999)The carbon.FromTime() function gets Carbon object by hour, minute, second:
carbon.FromTime(13, 14, 15)The carbon.FromTimeMilli() function gets Carbon object by hour, minute, second, millisecond:
carbon.FromTimeMilli(13, 14, 15, 999)The carbon.FromTimeMicro() function gets Carbon object by hour, minute, second, microsecond:
carbon.FromTimeMicro(13, 14, 15, 999999)The carbon.FromTimeNano() function gets Carbon object by hour, minute, second, nanosecond:
carbon.FromTimeNano(13, 14, 15, 999999999)The carbon.FromStdTime() function gets Carbon object by time.Time:
carbon.FromStdTime(time.Now())import "github.com/goravel/framework/support/debug"The debug.Dump() function prints any variable:
debug.Dump(myVar1, myVar2, ...)The debug.FDump() function prints any variable to io.Writer:
debug.FDump(someWriter, myVar1, myVar2, ...)The debug.SDump() function prints any variable to string:
debug.SDump(myVar1, myVar2, ...)import "github.com/goravel/framework/support/maps"The maps.Add() function adds a new key-value pair to the given map if the key does not already exist in the map:
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"}The maps.Exists() function determines if the given key exists in the provided map:
mp := map[string]any{"name": "Krishan", "age": 22}
maps.Exists(mp, "name") // true
maps.Exists(mp, "email") // falseThe maps.Forget() function removes the given key(s) from the provided map:
mp := map[string]string{"name": "Krishan", "age": "22"}
maps.Forget(mp, "name", "age")
// map[string]string{}The maps.Get() function retrieves the value of the given key from the provided map. If the key does not exist, the default value will be returned:
mp := map[string]any{"name": "Bowen"}
maps.Get(mp, "name", "Krishan") // Bowen
maps.Get(mp, "age", 22) // 22The maps.Has() function determines if the given key(s) exists in the provided map:
mp := map[string]any{"name": "Goravel", "language": "Go"}
maps.Has(mp, "name", "language") // true
maps.Has(mp, "name", "age") // falseThe maps.HasAny() function determines if any of the given key(s) exists in the provided map:
mp := map[string]any{"name": "Goravel", "language": "Go"}
maps.HasAny(mp, "name", "age") // true
maps.HasAny(mp, "age", "email") // falseThe maps.Only() function retrieves only the given key(s) from the provided map:
mp := map[string]any{"name": "Goravel", "language": "Go"}
maps.Only(mp, "name")
// map[string]any{"name": "Goravel"}
maps.Only(mp, "name", "age")
// map[string]any{"name": "Goravel"}The maps.Pull() function retrieves and removes the given key from the provided map:
mp := map[string]any{"name": "Goravel", "language": "Go"}
maps.Pull(mp, "name")
// map[string]any{"language": "Go"}A default value can be provided as the third argument to the maps.Pull() function. This value will be returned if the key does not exist in the map:
mp := map[string]any{"name": "Goravel", "language": "Go"}
maps.Pull(mp, "age", "default")
// map[string]any{"name": "Goravel", "language": "Go"}The maps.Set() function sets the given key and value in the provided map:
mp := map[string]any{"name": "Goravel"}
maps.Set(mp, "language", "Go")
// map[string]any{"name": "Goravel", "language": "Go"}The maps.Where() function filters the provided map using the given callback:
mp := map[string]string{"name": "Goravel", "language": "Go"}
maps.Where(mp, func(key string, value string) bool {
return key == "name"
})
// map[string]string{"name": "Goravel"}import "github.com/goravel/framework/support/convert"The convert.Tap() function passes the given value to the provided callback and returns the value:
convert.Tap("Goravel", func(value string) {
fmt.Println(value + " Framework")
})
// Goravel
mp := map[string]string{"name": "Goravel"}
convert.Tap(mp, func(value map[string]string) {
mp["language"] = "Go"
})
// map[string]string{"name": "Goravel", "language": "Go"}The convert.Transform() transforms the given value using the provided callback and returns the result:
convert.Transform(1, strconv.Itoa)
// "1"
convert.Transform("foo", func(s string) *foo {
return &foo{Name: s}
})
// &foo{Name: "foo"}The convert.With() executes the given callback with the provided value and returns the result of the callback:
convert.With("Goravel", func(value string) string {
return value + " Framework"
})
// Goravel FrameworkThe convert.Default() method returns first non-zero value. If all values are zero, it returns zero value.
convert.Default("", "foo") // foo
convert.Default("bar", "foo") // bar
convert.Default(0, 1) // 1The convert.Pointer() method returns the pointer of the given value.
convert.Pointer("foo") // *string("foo")
convert.Pointer(1) // *int(1)import "github.com/goravel/framework/support/collect"The collect.Count() function returns the number of items in the given collection:
collect.Count([]string{"Goravel", "Framework"}) // 2The collect.CountBy() function counts the occurrences for which the predicate is true:
collect.CountBy([]string{"Goravel", "Framework"}, func(value string) bool {
return strings.Contains(value, "Goravel")
})
// 1The collect.Each() function iterates over the items in the given collection and passes each item to the given callback:
collect.Each([]string{"Goravel", "Framework"}, func(value string, index int) {
fmt.Println(index + 1, value)
})
// 1 Goravel
// 2 FrameworkThe collect.Filter() function filters the items in the collection using the given callback:
collect.Filter([]string{"Goravel", "Framework"}, func(value string) bool {
return strings.Contains(value, "Goravel")
})
// []string{"Goravel"}The collect.GroupBy() function groups the items in the collection by the result of the given callback:
// use example of complex map slice (use different example)
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"}},
// }The collect.Keys() function returns all the keys for the items in the collection:
collect.Keys(map[string]string{"name": "Goravel", "language": "Go"})
// []string{"name", "language"}The collect.Map() function converts one type of collection into another using the given iteratee:
collect.Map([]string{"Goravel", "Framework"}, func(value string, _ int) string {
return strings.ToUpper(value)
})
// []string{"GORAVEL", "FRAMEWORK"}The collect.Max() function returns the maximum value of the given collection:
collect.Max([]int{1, 2, 3, 4, 5}) // 5The collect.Merge() function merges the given maps into a single map:
collect.Merge(map[string]string{"name": "Goravel"}, map[string]string{"language": "Go"})
// map[string]string{"name": "Goravel", "language": "Go"}
collect.Merge(map[string]string{"name": "Goravel"}, map[string]string{"name": "Framework"})
// map[string]string{"name": "Framework"}The collect.Min() function returns the minimum value of the given collection:
collect.Min([]int{1, 2, 3, 4, 5}) // 1The collect.Reverse() function reverses the items in the collection:
collect.Reverse([]string{"Goravel", "Framework"})
// []string{"Framework", "Goravel"}The collect.Shuffle() function shuffles the items in the collection:
collect.Shuffle([]int{1, 2, 3, 4, 5})
// []int{3, 1, 5, 2, 4}(example)The collect.Split() function splits a collection into the groups of the given length. If the collection can't be split evenly, the final chunk will contain the remaining items:
collect.Split([]int{1, 2, 3, 4, 5}, 2)
// [][]int{{1, 2}, {3, 4}, {5}}The collect.Sum() function returns the sum of all items in the collection:
collect.Sum([]int{1, 2, 3, 4, 5}) // 15The collect.Unique() method returns the duplicate-free collection where in case of duplicate values, only the first occurrence will be kept:
collect.Unique([]string{"Goravel", "Framework", "Goravel"})
// []string{"Goravel", "Framework"}The collect.Values() function returns all the values of the given collection:
collect.Values(map[string]string{"name": "Goravel", "language": "Go"})
// []string{"Goravel", "Go"}