شروع سریع
به راهنمای شروع سریع Gin خوش آمدید! این راهنما شما را قدمبهقدم از نصب Gin، راهاندازی پروژه، تا اجرای اولین API همراهی میکند تا بتوانید با اعتماد به نفس سرویسهای وب بسازید.
پیشنیازها
- Go: نسخه 1.23 یا بالاتر باید نصب باشد.
- اطمینان حاصل کنید Go در
PATHشما قرار دارد و از طریق ترمینال قابل اجراست. برای راهنمای نصب مستندات رسمی Go را ببینید.
گام 1: نصب Gin و راهاندازی پروژه
ابتدا یک پوشه جدید برای پروژه بسازید و یک ماژول Go راهاندازی کنید:
mkdir gin-quickstart && cd gin-quickstartgo mod init gin-quickstartاضافه کردن Gin به وابستگیها:
go get -u github.com/gin-gonic/ginگام 2: ایجاد اولین برنامه Gin
یک فایل با نام main.go بسازید:
touch main.goفایل main.go را باز کنید و کد زیر را وارد نمایید:
package main
import "github.com/gin-gonic/gin"
func main() { router := gin.Default() router.GET("/ping", func(c *gin.Context) { c.JSON(200, gin.H{ "message": "pong", }) }) router.Run() // به طور پیشفرض روی 0.0.0.0:8080 گوش میدهد}گام 3: اجرای سرور API
سرور را با دستور زیر اجرا کنید:
go run main.goسپس در مرورگر به آدرس http://localhost:8080/ping مراجعه کنید و باید خروجی زیر را ببینید:
{"message":"pong"}مثال اضافی: استفاده از net/http همراه با Gin
اگر میخواهید از ثابتهای net/http برای کدهای پاسخ استفاده کنید، آن را نیز import کنید:
package main
import ( "github.com/gin-gonic/gin" "net/http")
func main() { router := gin.Default() router.GET("/ping", func(c *gin.Context) { c.JSON(http.StatusOK, gin.H{ "message": "pong", }) }) router.Run()}نکات و منابع
-
تازهوارد به Go هستید؟ آموزش نوشتن و اجرای کد Go را اینجا ببینید.
-
برای مثال کاملتر میتوانید از دستور زیر استفاده کنید:
Terminal window curl https://raw.githubusercontent.com/gin-gonic/examples/master/basic/main.go > main.go -
برای مستندات کاملتر، به مستندات کد منبع Gin مراجعه کنید.