fiber/.github/README_ko.md

Fiber는 Express에서 영감을 받고, Go를 위한 가장 빠른 HTTP 엔진인 Fasthttp를 토대로 만들어진 web framework 입니다. 비 메모리 할당과 성능을 고려한 빠른 개발을 위해 손쉽게 사용되도록 설계되었습니다.

⚡️ 빠른 시작

package main

import "github.com/gofiber/fiber"

func main() {
  app := fiber.New()

  app.Get("/", func(c *fiber.Ctx) {
    c.Send("Hello, World!")
  })

  app.Listen(3000)
}

⚙️ 설치

우선, Go를 다운로드하고 설치합니다. 1.11 버전 이상이 요구됩니다.

go get 명령어를 이용해 설치가 완료됩니다:

go get github.com/gofiber/fiber

🤖 벤치마크

이 테스트들은 TechEmpower와 Go Web을 통해 측정되었습니다. 만약 모든 결과를 보고 싶다면, Wiki를 확인해 주세요.

🎯 특징

• 견고한 라우팅
• 정적 파일 제공
• 뛰어난 성능
• 적은 메모리 공간
• API 엔드포인트
• 미들웨어 & Next 지원
• 빠른 서버 사이드 프로그래밍
• 5개 언어로 번역됨
• 더 알고 싶다면, Fiber 둘러보기

💡 철학

Node.js에서 Go로 전환하는 새로운 고퍼분들은 웹 어플리케이션이나 마이크로 서비스 개발을 시작할 수 있게 되기 전에 학습 곡선에 시달리고 있습니다. Fiber는 web framework로서, 새로운 고퍼분들이 따뜻하고 믿음직한 환영을 가지고 빠르게 Go의 세상에 진입할 수 있게 미니멀리즘의 개념과 UNIX 방식에 따라 개발되었습니다.

Fiber는 인터넷에서 가장 인기있는 웹 프레임워크인 Express에서 영감을 받았습니다. 우리는 Express의 쉬운 사용과 Go의 성능을 결합하였습니다. 만약 당신이 Node.js (Express 또는 비슷한 것을 사용하여) 로 웹 어플리케이션을 개발한 경험이 있다면, 많은 메소드들과 원리들이 매우 비슷하게 느껴질 것 입니다.

👀 예제

다음은 일반적인 예제들 입니다. 더 많은 코드 예제를 보고 싶다면, Recipes 저장소 또는 API 문서를 방문하세요.

정적 파일

func main() {
  app := fiber.New()

  app.Static("./public")
  // => http://localhost:3000/js/script.js
  // => http://localhost:3000/css/style.css

  app.Static("/prefix", "./public")
  // => http://localhost:3000/prefix/js/script.js
  // => http://localhost:3000/prefix/css/style.css

  app.Listen(3000)
}

라우팅

func main() {
  app := fiber.New()

  // GET /john
  app.Get("/:name", func(c *fiber.Ctx) {
    fmt.Printf("Hello %s!", c.Params("name"))
    // => Hello john!
  })

  // GET /john
  app.Get("/:name/:age?", func(c *fiber.Ctx) {
    fmt.Printf("Name: %s, Age: %s", c.Params("name"), c.Params("age"))
    // => Name: john, Age:
  })

  // GET /api/register
  app.Get("/api*", func(c *fiber.Ctx) {
    fmt.Printf("/api%s", c.Params("*"))
    // => /api/register
  })

  app.Listen(3000)
}

미들웨어

func main() {
  app := fiber.New()

  // Match any post route
  app.Post(func(c *fiber.Ctx) {
    user, pass, ok := c.BasicAuth()
    if !ok || user != "john" || pass != "doe" {
      c.Status(403).Send("Sorry John")
      return
    }
    c.Next()
  })

  // Match all routes starting with /api
  app.Use("/api", func(c *fiber.Ctx) {
    c.Set("Access-Control-Allow-Origin", "*")
    c.Set("Access-Control-Allow-Headers", "X-Requested-With")
    c.Next()
  })

  // Optional param
  app.Post("/api/register", func(c *fiber.Ctx) {
    username := c.Body("username")
    password := c.Body("password")
    // ..
  })

  app.Listen(3000)
}

404 처리

func main() {
  app := fiber.New()

  // Serve static files from "public" directory
  app.Static("./public")

  // Last middleware
  app.Use(func (c *fiber.Ctx) {
    c.SendStatus(404) // => 404 "Not Found"
  })

  app.Listen(3000)
}

JSON 응답

func main() {
  app := fiber.New()

  type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
  }

  // Serialize JSON
  app.Get("/json", func (c *fiber.Ctx) {
    c.JSON(&User{"John", 20})
  })

  app.Listen(3000)
}

💬 미디어

• Welcome to Fiber — an Express.js styled web framework written in Go with ❤️ by Vic Shóstak, 03 Feb 2020

👍 기여

fiber의 활발한 개발을 지원하고 감사 인사를 하고 싶다면:

1. 프로젝트에 GitHub Star를 추가하세요.
2. 트위터에서 프로젝트에 대해 트윗하세요.
3. Medium, Dev.to 또는 개인 블로그에 리뷰 또는 튜토리얼을 작성하세요.
4. README 와 API 문서를 다른 언어로 번역하는 것을 도와주세요.

⭐️ Stars

⚠️ 라이센스

Fiber 는 MIT License에 따른 무료 오픈소스 소프트웨어 입니다.