安装

服务器要求

Golang >= 1.21

安装 Goravel

安装前需先设置 GOPROXY（详见文章），或开启 VPN。

使用 Goravel 安装器

根据文档初始化安装器，然后使用下面命令初始化一个新的 Goravel 项目：

// 进入想要安装项目的目录
goravel new blog

手动安装

// 下载框架
git clone --depth=1 https://github.com/goravel/goravel.git && rm -rf goravel/.git*

// 安装依赖
cd goravel && go mod tidy

// 创建 .env 环境配置文件
cp .env.example .env

// 生成应用密钥
go run . artisan key:generate

如果安装依赖较慢，请使用国内代理，详见文章。

启动 HTTP 服务

根据根目录下的 .env 文件启动服务

go run .

指定 .env 文件启动服务

go run . --env=../.env

使用环境变量启动服务

APP_ENV=production APP_DEBUG=true go run .

热更新

安装 cosmtrek/air，框架内置配置文件，可直接使用：

air

如果是 Windows 系统，需要修改根目录下 .air.toml 文件，为下面两行增加 .exe 后缀：

[build]
  bin = "./storage/temp/main.exe"
  cmd = "go build -o ./storage/temp/main.exe ."

配置

配置文件

Goravel 框架所有的配置文件都放在 config 目录中。每个配置项都有注释，可以根据自身需求进行调整。

生成密钥

Goravel 安装到本地后，要生成应用程序的密钥。运行下面命令后会在 .env 文件的 APP_KEY 键上生成 32 位字符串，该密钥主要作用于数据加解密等功能。

go run . artisan key:generate

生成 JWT Token

如果使用到了用户认证功能，需要初始化 JWT Token。

go run . artisan jwt:secret