安裝

• 伺服器要求
• 安裝
  • 使用 Goravel 安裝器
  • 手動安裝
• 啟動 HTTP 服務
  • 根據根目錄中的 .env 文件啟動服務
  • 指定 .env 文件啟動服務
  • 使用環境變量啟動服務
  • 即時重新加載
• 配置
  • 配置文件
  • 生成應用密鑰
  • 生成JWT Token
  • 加解密 env 文件

伺服器要求

• Golang >= 1.23

安裝

使用 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，Goravel 具備可以直接使用的內建配置文件：

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

加解密 env 文件

您可能希望將生產環境的 env 文件添加到版本控制中，但不想暴露敏感信息，您可以使用 env:encrypt 命令加密 env 文件：

go run . artisan env:encrypt

// 指定文件名與密鑰
go run . artisan env.encrypt --name .env.safe --key BgcELROHL8sAV568T7Fiki7krjLHOkUc

然後在生產環境中使用 env:decrypt 命令來解密 env 文件：

GORAVEL_ENV_ENCRYPTION_KEY=BgcELROHL8sAV568T7Fiki7krjLHOkUc go run . artisan env:decrypt

// 或
go run . artisan env.decrypt --name .env.safe --key BgcELROHL8sAV568T7Fiki7krjLHOkUc