1
0
mirror of https://github.com/gofiber/fiber.git synced 2025-02-24 19:04:33 +00:00
fiber/.github/README_ru.md

324 lines
13 KiB
Markdown
Raw Normal View History

2020-02-12 00:04:27 +01:00
<p align="center">
<a href="https://fiber.wiki">
2020-02-21 16:54:14 +01:00
<img alt="Fiber" height="100" src="https://github.com/gofiber/docs/blob/master/static/logo.svg">
2020-02-12 00:04:27 +01:00
</a>
2020-02-21 16:54:14 +01:00
<br><br>
2020-02-14 02:05:39 +01:00
<a href="https://github.com/gofiber/fiber/blob/master/.github/README.md">
2020-02-12 00:04:27 +01:00
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/gb.svg">
</a>
2020-02-12 23:32:31 +03:00
<!--<a href="https://github.com/gofiber/fiber/blob/master/.github/README_ru.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/ru.svg">
</a>-->
2020-02-12 00:04:27 +01:00
<a href="https://github.com/gofiber/fiber/blob/master/.github/README_es.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/es.svg">
</a>
<a href="https://github.com/gofiber/fiber/blob/master/.github/README_ja.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/jp.svg">
</a>
<a href="https://github.com/gofiber/fiber/blob/master/.github/README_pt.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/pt.svg">
</a>
<a href="https://github.com/gofiber/fiber/blob/master/.github/README_zh-CN.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/cn.svg">
</a>
<a href="https://github.com/gofiber/fiber/blob/master/.github/README_de.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/de.svg">
</a>
2020-02-12 01:03:56 +01:00
<a href="https://github.com/gofiber/fiber/blob/master/.github/README_ko.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/kr.svg">
</a>
<a href="https://github.com/gofiber/fiber/blob/master/.github/README_fr.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/fr.svg">
</a>
2020-02-19 15:48:41 +03:00
<a href="https://github.com/gofiber/fiber/blob/master/.github/README_tr.md">
<img height="20px" src="https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/tr.svg">
</a>
2020-02-12 00:04:27 +01:00
<br><br>
<a href="https://github.com/gofiber/fiber/releases">
<img src="https://img.shields.io/github/release/gofiber/fiber?style=flat-square">
</a>
<a href="https://fiber.wiki">
<img src="https://img.shields.io/badge/api-documentation-blue?style=flat-square">
</a>
<a href="#">
<img src="https://img.shields.io/badge/goreport-A%2B-brightgreen?style=flat-square">
</a>
<a href="https://gocover.io/github.com/gofiber/fiber">
<img src="https://img.shields.io/badge/coverage-91%25-brightgreen?style=flat-square">
</a>
<a href="https://travis-ci.org/gofiber/fiber">
<img src="https://img.shields.io/travis/gofiber/fiber/master.svg?label=linux&style=flat-square">
</a>
<a href="https://travis-ci.org/gofiber/fiber">
<img src="https://img.shields.io/travis/gofiber/fiber/master.svg?label=windows&style=flat-square">
</a>
2020-02-12 23:34:45 +03:00
<a href="https://travis-ci.org/gofiber/fiber">
<img src="https://img.shields.io/travis/gofiber/fiber/master.svg?label=osx&style=flat-square">
</a>
2020-02-12 00:04:27 +01:00
</p>
<p align="center">
2020-02-12 23:32:31 +03:00
<strong>Fiber</strong> — это <strong>веб фреймворк</strong>, который был вдохновлен <a href="https://github.com/expressjs/express">Express</a> и основан на <a href="https://github.com/valyala/fasthttp">Fasthttp</a>, самом быстром HTTP-движке написанном на <a href="https://golang.org/doc/">Go</a>. Фреймворк был разработан с целью <strong>упростить</strong> процесс <strong>быстрой</strong> разработки <strong>высокопроизводительных</strong> веб-приложений с <strong>нулевым распределением памяти</strong>.
2020-02-12 00:04:27 +01:00
</p>
2020-02-11 00:32:01 +00:00
## ⚡️ Быстрый старт
```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(3000)
}
```
## ⚙️ Установка
2020-02-19 18:05:58 +03:00
Прежде всего, [скачайте](https://golang.org/dl/) и установите Go. Версия **1.11** или выше.
2020-02-11 00:32:01 +00:00
2020-02-19 18:03:55 +03:00
Установка выполняется с помощью команды [`go get`](https://golang.org/cmd/go/#hdr-Add_dependencies_to_current_module_and_install_them):
2020-02-11 00:32:01 +00:00
```bash
2020-02-12 23:32:31 +03:00
go get -u github.com/gofiber/fiber
2020-02-11 00:32:01 +00:00
```
2020-02-12 23:32:31 +03:00
## 🤖 Бенчмарки
2020-02-11 00:32:01 +00:00
2020-02-12 23:32:31 +03:00
Тестирование проводилось с помощью [TechEmpower](https://github.com/TechEmpower/FrameworkBenchmarks) и [Go Web](https://github.com/smallnest/go-web-framework-benchmark). Если вы хотите увидеть все результаты, пожалуйста, посетите наш [Wiki](https://fiber.wiki/benchmarks).
2020-02-11 00:32:01 +00:00
<p float="left" align="middle">
2020-02-11 02:31:22 +01:00
<img src="https://github.com/gofiber/docs/blob/master/.gitbook/assets//benchmark-pipeline.png" width="49%">
<img src="https://github.com/gofiber/docs/blob/master/.gitbook/assets//benchmark_alloc.png" width="49%">
2020-02-11 00:32:01 +00:00
</p>
## 🎯 Особенности
- Надежная [маршрутизация](https://fiber.wiki/routing)
2020-02-12 23:32:31 +03:00
- Доступ к [статичным файлам](https://fiber.wiki/application#static)
2020-02-11 00:32:01 +00:00
- Экстремальная [производительность](https://fiber.wiki/benchmarks)
2020-02-12 23:32:31 +03:00
- [Низкий объем потребления памяти](https://fiber.wiki/benchmarks)
2020-02-16 22:46:43 +03:00
- [Эндпоинты](https://fiber.wiki/context), как в [API](https://fiber.wiki/context) Express
2020-02-12 23:32:31 +03:00
- Middleware и поддержка [Next](https://fiber.wiki/context#next)
2020-02-11 00:32:01 +00:00
- [Быстрое](https://dev.to/koddr/welcome-to-fiber-an-express-js-styled-fastest-web-framework-written-with-on-golang-497) программирование на стороне сервера
2020-02-19 17:58:06 +03:00
- Переведен на 9 других языков
2020-02-12 23:32:31 +03:00
- И многое другое, [посетите наш Wiki](https://fiber.wiki/)
2020-02-11 00:32:01 +00:00
## 💡 Философия
2020-02-12 23:32:31 +03:00
Новые Go-программисты, которые переключаются с [Node.js](https://nodejs.org/en/about/) на [Go](https://golang.org/doc/), имеют дело с очень извилистой кривой обучения, прежде чем они смогут начать создавать свои веб-приложения или микросервисы. Fiber, как **веб-фреймворк**, был создан с идеей **минимализма** и следовал **принципу UNIX**, так что новички смогут быстро войти в мир Go без особых проблем.
2020-02-11 00:32:01 +00:00
2020-02-12 23:32:31 +03:00
Fiber **вдохновлен** Express, самым популярным веб фреймворком в Интернете. Мы объединили **простоту** Express и **чистую производительность** Go. Если вы когда-либо реализовывали веб-приложение на Node.js (*с использованием Express или аналогичного фреймворка*), то многие методы и принципы покажутся вам **очень знакомыми**.
2020-02-11 00:32:01 +00:00
2020-02-19 17:58:06 +03:00
Мы **прислушиваемся** к нашим пользователям в [issues](https://github.com/gofiber/fiber/issues) (_и остальном Интернете_), чтобы создать **быстрый**, **гибкий** и **дружелюбный** веб фреймворк на Go для **любых** задач, **дедлайнов** и **уровней** разработчиков! Как это делает Express в мире JavaScript.
2020-02-11 00:32:01 +00:00
## 👀 Примеры
2020-02-12 23:32:31 +03:00
Ниже перечислены некоторые из распространенных примеров. Если вы хотите увидеть больше примеров кода, пожалуйста, посетите наш [репозиторий рецептов](https://github.com/gofiber/recipes) или [документацию по API](https://fiber.wiki).
2020-02-11 00:32:01 +00:00
2020-02-19 18:03:13 +03:00
### Роутинг
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// GET /john
app.Get("/:name", func(c *fiber.Ctx) {
fmt.Printf("Hello %s!", c.Params("name"))
// => Hello john!
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// 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:
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// GET /api/register
app.Get("/api*", func(c *fiber.Ctx) {
fmt.Printf("/api%s", c.Params("*"))
// => /api/register
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:32:01 +00:00
2020-02-19 18:03:13 +03:00
### Обслуживание статичных файлов
2020-02-16 22:46:43 +03:00
```go
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.Static("*", "/public/index.html")
// => http://localhost:3000/any/path/shows/index/html
app.Listen(3000)
}
```
2020-02-19 18:03:13 +03:00
### Middleware и функция Next
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// Match any route
app.Use(func(c *fiber.Ctx) {
fmt.Println("First middleware")
c.Next()
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// Match all routes starting with /api
app.Use("/api", func(c *fiber.Ctx) {
fmt.Println("Second middleware")
c.Next()
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// POST /api/register
app.Post("/api/register", func(c *fiber.Ctx) {
fmt.Println("Last middleware")
c.Send("Hello, World!")
})
app.Listen(3000)
}
```
2020-02-11 00:32:01 +00:00
2020-02-14 02:24:06 +01:00
<details>
2020-02-16 22:46:43 +03:00
<summary>📚 Показать больше примеров кода</summary>
2020-02-16 18:00:14 +01:00
2020-02-19 17:58:06 +03:00
### Обработка 404 ошибки
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
app.Static("/public")
2020-02-21 16:54:14 +01:00
2020-02-16 18:00:14 +01:00
app.Get("/demo", func(c *fiber.Ctx) {
c.Send("This is a demo!")
})
2020-02-21 16:54:14 +01:00
2020-02-16 18:00:14 +01:00
app.Post("/register", func(c *fiber.Ctx) {
c.Send("Welcome!")
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// Last middleware to match anything
app.Use(func(c *fiber.Ctx) {
c.SendStatus(404) // => 404 "Not Found"
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:32:01 +00:00
2020-02-19 18:03:13 +03:00
### Ответ в формате JSON
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
type User struct {
Name string `json:"name"`
Age int `json:"age"`
2020-02-11 00:32:01 +00:00
}
2020-02-16 18:00:14 +01:00
// Serialize JSON
app.Get("/json", func(c *fiber.Ctx) {
c.JSON(&User{"John", 20})
// => {"name":"John", "age":20}
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:32:01 +00:00
2020-02-19 18:03:13 +03:00
### Восстановление работы после `panic`
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
app.Get("/", func(c *fiber.Ctx) {
panic("Something went wrong!")
})
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
app.Recover(func(c *fiber.Ctx) {
c.Status(500).Send(c.Error())
// => 500 "Something went wrong!"
})
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
</details>
2020-02-16 22:46:43 +03:00
2020-02-12 23:40:20 +03:00
## 💬 Медиа
2020-02-11 00:32:01 +00:00
2020-02-12 23:40:20 +03:00
- [Welcome to Fiber — an Express.js styled web framework written in Go with ❤️](https://dev.to/koddr/welcome-to-fiber-an-express-js-styled-fastest-web-framework-written-with-on-golang-497) *[Vic Shóstak](https://github.com/koddr), 3 февраля 2020 г.*
2020-02-11 00:32:01 +00:00
2020-02-12 23:32:31 +03:00
## 👍 Помощь проекту
2020-02-11 00:32:01 +00:00
2020-02-12 23:32:31 +03:00
Если вы хотите сказать **спасибо** и/или поддержать активное развитие `Fiber`:
2020-02-11 00:32:01 +00:00
1. Добавьте [GitHub Star](https://github.com/gofiber/fiber/stargazers) в проект.
2020-02-12 23:32:31 +03:00
2. Напишите о проекте [в вашем Twitter](https://twitter.com/intent/tweet?text=%F0%9F%9A%80%20Fiber%20%E2%80%94%20is%20an%20Express.js%20inspired%20web%20framework%20build%20on%20Fasthttp%20for%20%23Go%20https%3A%2F%2Fgithub.com%2Fgofiber%2Ffiber).
3. Сделайте обзор фреймворка на [Medium](https://medium.com/), [Dev.to](https://dev.to/) или в личном блоге.
4. Помогите нам перевести `README` и [API](https://fiber.wiki/) на другой язык.
2020-02-11 00:32:01 +00:00
2020-02-19 18:03:13 +03:00
## ☕ Те, кто уже поддержал проект
2020-02-12 03:54:54 +01:00
2020-02-16 18:00:14 +01:00
<a href="https://www.buymeacoffee.com/fenny" target="_blank">
<img src="https://github.com/gofiber/docs/blob/master/static/buy-morning-coffee-3x.gif" alt="Buy Me A Coffee" height="100" >
</a>
2020-02-12 03:54:54 +01:00
<table>
<tr>
<td align="center">
2020-02-14 02:05:39 +01:00
<a href="https://github.com/bihe">
2020-02-16 18:00:14 +01:00
<img src="https://avatars1.githubusercontent.com/u/635852?s=460&v=4" width="100px"></br>
2020-02-14 02:05:39 +01:00
<sub><b>HenrikBinggl</b></sub>
2020-02-12 03:54:54 +01:00
</a>
2020-02-14 02:05:39 +01:00
</td>
<td align="center">
<a href="https://github.com/koddr">
2020-02-16 18:00:14 +01:00
<img src="https://avatars0.githubusercontent.com/u/11155743?s=460&v=4" width="100px"></br>
2020-02-16 22:46:43 +03:00
<sub><b>Vic Shóstak</b></sub>
2020-02-14 02:05:39 +01:00
</a>
</td>
<td align="center">
<a href="https://github.com/MarvinJWendt">
2020-02-16 18:00:14 +01:00
<img src="https://avatars1.githubusercontent.com/u/31022056?s=460&v=4" width="100px"></br>
2020-02-14 02:05:39 +01:00
<sub><b>MarvinJWendt</b></sub>
</a>
</td>
<td align="center">
<a href="https://github.com/toishy">
2020-02-16 18:00:14 +01:00
<img src="https://avatars1.githubusercontent.com/u/31921460?s=460&v=4" width="100px"></br>
2020-02-14 02:05:39 +01:00
<sub><b>ToishY</b></sub>
</a>
</td>
2020-02-12 03:54:54 +01:00
</tr>
</table>
## ⭐️ Звезды
2020-02-11 00:32:01 +00:00
<a href="https://starchart.cc/gofiber/fiber" rel="nofollow"><img src="https://starchart.cc/gofiber/fiber.svg" alt="Stars over time" style="max-width:100%;"></a>
## ⚠️ Лицензия
2020-02-12 23:49:35 +03:00
`Fiber` — это бесплатное программное обеспечение с открытым исходным кодом, лицензированное по [лицензии MIT](https://github.com/gofiber/fiber/blob/master/LICENSE).