استفاده از فایل‌های config با Viper

کتابخانه Viper یکی از قدرتمندترین ابزارها برای مدیریت تنظیمات و پیکربندی در زبان برنامه‌نویسی گولنگ (Go) است. این کتابخانه قابلیت‌های متعددی مانند پشتیبانی از فرمت‌های مختلف فایل، خواندن متغیرهای محیطی و حتی پیکربندی داینامیک را فراهم می‌کند. در این مقاله، با روش استفاده از Viper برای مدیریت فایل‌های config آشنا می‌شویم.

چرا Viper؟

مدیریت تنظیمات پروژه‌های نرم‌افزاری یکی از وظایف مهم در توسعه نرم‌افزار است. ویژگی‌های کلیدی Viper عبارتند از:

• پشتیبانی از فرمت‌های متنوع مانند JSON، YAML، TOML و HCL
• خواندن متغیرهای محیطی
• امکان استفاده به صورت داینامیک و تغییر تنظیمات در زمان اجرا

نصب Viper

برای نصب Viper کافیست دستور زیر را اجرا کنید:

go get github.com/spf13/viper

پس از نصب، می‌توانید آن را در پروژه خود وارد کنید:

import "github.com/spf13/viper"

مثال عملی: خواندن تنظیمات از یک فایل YAML

فرض کنیم یک فایل config.yaml داریم که به شکل زیر تعریف شده است:

server:
  port: 8080
  host: "localhost"
database:
  user: "admin"
  password: "secret"
  name: "mydb"

برای خواندن این تنظیمات با استفاده از Viper، ابتدا باید مسیر فایل را مشخص کنیم:

// main.go
package main

import (
    "fmt"
    "github.com/spf13/viper"
)

func main() {
    // تنظیم مسیر فایل
    viper.SetConfigName("config")
    viper.SetConfigType("yaml")
    viper.AddConfigPath(".")

    // خواندن فایل تنظیمات
    err := viper.ReadInConfig()
    if err != nil {
        panic(fmt.Errorf("خطا در خواندن فایل config: %s", err))
    }

    // دسترسی به مقادیر تنظیمات
    serverPort := viper.GetInt("server.port")
    serverHost := viper.GetString("server.host")
    dbUser := viper.GetString("database.user")

    fmt.Printf("Server running on %s:%d\n", serverHost, serverPort)
    fmt.Printf("Database user: %s\n", dbUser)
}

خواندن متغیرهای محیطی

یکی دیگر از ویژگی‌های مفید Viper امکان خواندن مقادیر از متغیرهای محیطی است. برای فعال کردن این قابلیت، کافیست نام متغیرها را مشخص کنید:

// فعال کردن متغیرهای محیطی
viper.AutomaticEnv()
viper.SetEnvPrefix("app") // پیشوند برای متغیرها
port := viper.GetInt("PORT") // مقدار PORT را بخوانید

نتیجه‌گیری

کتابخانه Viper ابزاری قدرتمند برای مدیریت فایل‌های پیکربندی در گولنگ است که به توسعه‌دهندگان کمک می‌کند تا پروژه‌هایی انعطاف‌پذیر و قابل مدیریت ایجاد کنند. با قابلیت‌هایی مثل خواندن فرمت‌های مختلف و پشتیبانی از متغیرهای محیطی، این ابزار انتخابی عالی برای پروژه‌های حرفه‌ای محسوب می‌شود.