mirror of
https://github.com/gofiber/fiber.git
synced 2025-05-30 19:33:01 +00:00
77 lines
2.9 KiB
Markdown
77 lines
2.9 KiB
Markdown
<p align="center">
|
||
<img height="150" src="https://gofiber.github.io/fiber/static/logo.jpg">
|
||
</p>
|
||
|
||
# Fiber       
|
||
|
||
**[Fiber](https://github.com/gofiber/fiber)** is an **[Express](https://expressjs.com/en/4x/api.html)** style HTTP framework implementation running on **[FastHTTP](https://github.com/valyala/fasthttp)**, the **fastest** HTTP engine for **[Go](https://golang.org/doc/)**. The package make use of similar framework convention as they are in express.
|
||
|
||
|
||
## Features
|
||
* Optimized for speed and low memory usage.
|
||
* Rapid Server-Side Programming
|
||
* Easy routing with parameters
|
||
* Static files with custom prefix
|
||
* Middleware support
|
||
* Supports Express API endpoints
|
||
* **[API Documentation](https://gofiber.github.io/fiber/)**
|
||
|
||
## Why another framework?
|
||
People switching from **[Nodejs](https://nodejs.org/en/about/)** to **[Go](https://golang.org/doc/)** often end up in a bad learning curve to start building their webapps, this project is meant to **ease** things up for **fast** development, but with **zero memory allocation** and **performance** in mind.
|
||
|
||
## Installing
|
||
Assuming you’ve already installed **[Go](https://golang.org/doc/)**, install the **[Fiber](https://github.com/gofiber/fiber)** package by calling the following command:
|
||
```bash
|
||
$ go get -u github.com/gofiber/fiber
|
||
```
|
||
|
||
## Hello world
|
||
Embedded below is essentially the simplest Fiber app you can create.
|
||
```bash
|
||
$ create server.go
|
||
```
|
||
```go
|
||
package main
|
||
|
||
import "github.com/gofiber/fiber"
|
||
|
||
func main() {
|
||
app := fiber.New()
|
||
app.Get("/", func(c *fiber.Ctx) {
|
||
c.Send("Hello, World!")
|
||
})
|
||
app.Listen(8080)
|
||
}
|
||
```
|
||
```bash
|
||
$ go run server.go
|
||
```
|
||
Browse to **http://localhost:8080** and you should see Hello, World! on the page.
|
||
|
||
## Static files
|
||
To serve static files, use the [Static](https://gofiber.github.io/fiber/#/?id=static-files) method.
|
||
```go
|
||
package main
|
||
|
||
import "github.com/gofiber/fiber"
|
||
|
||
func main() {
|
||
app := fiber.New()
|
||
app.Static("./public")
|
||
app.Listen(8080)
|
||
}
|
||
```
|
||
Now, you can load the files that are in the public directory:
|
||
```shell
|
||
http://localhost:8080/images/kitten.jpg
|
||
http://localhost:8080/css/style.css
|
||
http://localhost:8080/js/app.js
|
||
http://localhost:8080/images/bg.png
|
||
http://localhost:8080/hello.html
|
||
```
|
||
|
||
## API Documentation
|
||
We created an extended API documentation including examples, **[click here](https://gofiber.github.io/fiber/)**
|
||
|
||
*Caught a mistake? [Edit this page on GitHub!](https://github.com/gofiber/fiber/blob/master/README.md)*
|