配置信息

简介

Goravel 框架所有配置文件都保存在 config 目录中。你可以进入具体文件查看配置说明,根据项目需要灵活配置。

环境配置

在不同的环境运行应用程序,通常需要不同的配置。例如,你可能希望在本地打开 Debug 模式,但生产环境不需要。

因此,框架在根目录提供了 .env.example 文件,需要你在开发前,复制该文件并重命名为 .env,根据项目需要修改 .env 文件中的配置项。

注意,.env 文件不应该加入版本控制,因为多人协作时,不同的开发人员有可能使用不同的配置,不同的部署环境配置也不相同。

此外,如果有入侵者获得了你的代码仓库访问权限,将会有暴露敏感配置的风险。如果你想新增新的配置项,可以添加到 .env.example 文件中,以此来同步所有开发者的配置。

获取环境配置

使用如下方法,可获取 .env 文件中的配置项:

// 第一个参数为配置键,第二个参数为默认值
facades.Config().Env("APP_NAME", "goravel")

获取配置值

你可以轻松的在应用程序的任何位置使用全局 facades.Config() 函数来访问 config 目录中的配置值。配置值的访问可以使用「点」语法。还可以指定默认值,如果配置选项不存在,则返回默认值:

// 通过断言获取配置
facades.Config().Get("app.name", "goravel")

// 获取字符串类型的配置
facades.Config().GetString("app.name", "goravel")

// 获取整形类型的配置
facades.Config().GetInt("app.int", 1)

// 获取布尔类型的配置
facades.Config().GetBool("app.debug", true)

设置配置值

facades.Config().Add("path", "value1")
facades.Config().Add("path.with.dot.case1", "value1")
facades.Config().Add("path.with.dot", map[string]any{"case3": "value3"})