2021-03-30 17:39:56 +08:00
# GoFrame
2022-01-12 20:42:11 +08:00
<div align=center>
<img src="https://goframe.org/statics/image/gf-head-large.png" width="100"/>
2018-12-17 20:44:38 +08:00
2021-03-30 18:00:44 +08:00
[](https://godoc.org/github.com/gogf/gf)
2022-02-02 11:18:22 +08:00
[](https://github.com/gogf/gf/actions/workflows/gf.yml)
2021-03-30 18:00:44 +08:00
[](https://goreportcard.com/report/github.com/gogf/gf)
[](https://codecov.io/gh/gogf/gf/branch/master)
[](https://github.com/gogf/gf)
[](https://github.com/gogf/gf)
2022-01-12 20:43:36 +08:00
</div>
2021-03-30 18:00:44 +08:00
2021-12-17 12:11:40 +08:00
`GoFrame` is a modular, powerful, high-performance and enterprise-class application development framework of Golang.
2018-08-06 12:59:08 +08:00
2022-01-12 20:42:11 +08:00
# Features
- modular, loosely coupled design
- rich components, out-of-the-box
2022-01-24 15:50:15 +08:00
- automatic codes generating for efficiency
2022-01-12 20:42:11 +08:00
- simple and easy to use, detailed documentation
- interface designed components, with high scalability
- fully supported tracing and error stack feature
- specially developed and powerful ORM component
- robust engineering design specifications
- convenient development CLI tool provide
- OpenTelemetry observability features support
- OpenAPIV3 documentation generating, automatically
- much, much more...ready to explore?
2020-02-22 17:06:58 +08:00
2019-06-25 23:17:14 +08:00
# Installation
2022-01-25 10:21:59 +08:00
Enter your repo. directory and execute following command:
2022-01-24 15:50:15 +08:00
## primary module
```bash
2021-10-11 21:43:27 +08:00
go get -u -v github.com/gogf/gf/v2
2018-08-06 23:05:07 +08:00
```
2022-01-24 15:50:15 +08:00
## cli tool
```bash
2022-01-25 10:21:59 +08:00
go install github.com/gogf/gf/cmd/gf/v2
2018-12-22 21:50:47 +08:00
```
2019-06-25 23:17:14 +08:00
# Limitation
2018-11-30 20:37:28 +08:00
```
2021-12-17 12:11:40 +08:00
golang version >= 1.15
2019-06-25 23:17:14 +08:00
```
2020-07-12 10:25:15 +08:00
# Architecture
<div align=center>
2021-02-07 15:34:36 +08:00
<img src="https://goframe.org/download/attachments/1114119/arch.png"/>
2020-07-12 10:25:15 +08:00
</div>
2019-06-25 23:17:14 +08:00
2020-04-23 17:23:57 +08:00
# Documentation
2022-01-12 20:42:11 +08:00
* Chinese Official Site(中文官网): [https://goframe.org](https://goframe.org/display/gf)
2021-04-16 10:32:55 +08:00
* GoDoc API: [https://pkg.go.dev/github.com/gogf/gf](https://pkg.go.dev/github.com/gogf/gf)
2020-04-23 17:23:57 +08:00
2019-06-25 23:17:14 +08:00
# License
2021-12-04 00:07:49 +08:00
`GoFrame` is licensed under the [MIT License](LICENSE), 100% free and open-source, forever.
2019-06-25 23:17:14 +08:00
2020-07-18 09:40:39 +08:00
# Part Of Users
2020-06-05 20:36:05 +08:00
2020-07-18 10:34:32 +08:00
- [Tencent](https://www.tencent.com/)
2020-07-18 09:40:39 +08:00
- [ZTE](https://www.zte.com.cn/china/)
- [Ant Financial Services](https://www.antfin.com/)
2021-12-04 00:07:05 +08:00
- [VIVO](https://www.vivo.com/)
2021-12-04 18:25:24 +08:00
- [MedLinker](https://www.medlinker.com/)
2020-07-18 09:40:39 +08:00
- [KuCoin](https://www.kucoin.io/)
2020-08-03 18:58:43 +08:00
- [LeYouJia](https://www.leyoujia.com/)
- [IGG](https://igg.com)
2021-12-04 00:05:54 +08:00
- [37](https://www.37.com)
2020-08-13 18:59:13 +08:00
- [XiMaLaYa](https://www.ximalaya.com)
2020-11-20 00:53:12 +08:00
- [ZYBang](https://www.zybang.com/)
2020-07-18 09:40:39 +08:00
2021-02-07 15:34:36 +08:00
> We list part of the users here, if your company or products are using `GoFrame`, please let us know [here](https://goframe.org/pages/viewpage.action?pageId=1114415).
2020-06-05 20:36:05 +08:00
2020-01-18 22:21:37 +08:00
# Contributors
This project exists thanks to all the people who contribute. [[Contributors](https://github.com/gogf/gf/graphs/contributors)].
2021-09-20 12:29:05 +08:00
<a href="https://github.com/gogf/gf/graphs/contributors"><img src="https://contributors-img.web.app/image?repo=gogf/gf" /></a>
2020-01-18 22:21:37 +08:00
2020-06-03 20:33:21 +08:00
2019-06-25 23:17:14 +08:00
# Donators
2021-12-04 00:07:49 +08:00
If you love `GoFrame`, why not [buy developer a cup of coffee](https://goframe.org/pages/viewpage.action?pageId=1115633)?
2019-06-25 23:17:14 +08:00
2020-02-22 17:06:58 +08:00
# Sponsors
2021-12-04 00:07:49 +08:00
We appreciate any kind of sponsorship for `GoFrame` development. If you've got some interesting, please contact WeChat `389961817` / Email `john@goframe.org`.
2020-06-03 20:33:21 +08:00
2020-02-22 17:06:58 +08:00
2020-06-05 20:36:05 +08:00
2019-06-25 23:17:14 +08:00
# Thanks
2021-02-07 15:34:36 +08:00
<a href="https://www.jetbrains.com/?from=GoFrame"><img src="https://goframe.org/download/thumbnails/1114119/jetbrains.png" height="120" alt="JetBrains"/></a>
2021-02-07 10:31:59 +08:00
<a href="https://www.atlassian.com/?from=GoFrame"><img src="https://goframe.org/download/attachments/1114119/atlassian.jpg" height="120" alt="Atlassian"/></a>
2018-12-27 09:49:50 +08:00
2020-02-22 17:06:58 +08:00
2019-05-18 14:55:15 +08:00
2020-06-05 20:36:05 +08:00
