快速上手
安装
要安装 Slim，需要 Go 1.21.0 或更高版本。
初始化项目
$ mkdir myapp && cd myapp$ go mod init myapp$ go get go-slim.dev/slim实例
任何类型为 slim.Slim 的对象都可以被认为是 Slim 的实例，我们可以在单个程序中使用任意数量的 Slim 实例。
普通实例
s := slim.New()使用函数 slim.New 仅仅初始化一个基本的 Slim 实例，没有注册任何中间件。
Hello world!
创建入口文件 server.go
server.go
package mainimport ( "net/http" "log" "go-slim.dev/slim")func main() { s := slim.New() s.GET("/", func(c slim.Context) error { return c.String(http.StatusOK, "Hello, World!") }) log.Fatal(s.Start(":1324"))}启动服务器
terminal
$ go run server.go打开网址 http://localhost:1324 ，我们能够在页面上看到字符串 Hello, World! 。
路由
定义 RESTful 路由
s.POST("/users", saveUser)s.GET("/users/:id", getUser)s.PUT("/users/:id", updateUser)s.DELETE("/users/:id", deleteUser)路径参数
处理路径参数
// s.GET("/users/:id", getUser)func getUser(c slim.Context) error { // User ID from path `users/:id` id := c.PathParam("id") return c.String(http.StatusOK, id)}打开网址 http://localhost:1324/users/joe ，我们会在页面上看到字符串 joe。
查询参数
处理查询参数
// s.GET("/show", show)func show(c slim.Context) error { // Get team and member from the query string team := c.QueryParam("team") member := c.QueryParam("member") return c.String(http.StatusOK, "team:" + team + ", member:" + member)}打开网址 http://localhost:1324/show?team=x-men&member=wolverine ，我们会在页面上看到字符串 team: x-men, member: wolverine。
表单数据
我们使用表单提交下面的数据：
| name | value |
|---|---|
| name | Joe Smith |
| joe@go-slim.dev |
处理表单数据
// s.POST("/save", save)func save(c slim.Context) error { // Get name and email name := c.FormValue("name") email := c.FormValue("email") return c.String(http.StatusOK, "name:" + name + ", email:" + email)}我们打开控制台，使用 curl 命令执行下面的命令模拟表单请求：
Terminal
$ curl -d "name=Joe Smith" -d "email=joe@go-slim.dev" http://localhost:1324/save// => name:Joe Smith, email:joe@go-slim.dev文件上传
我们使用表单提交下面的数据：
| name | value |
|---|---|
| name | Joe Smith |
| avatar | a avatar file |
处理文件上传
// s.POST("/save", save)func save(c slim.Context) error { // Get name name := c.FormValue("name") // Get avatar avatar, err := c.FormFile("avatar") if err != nil { return err } // Source src, err := avatar.Open() if err != nil { return err } defer src.Close() // Destination dst, err := os.Create(avatar.Filename) if err != nil { return err } defer dst.Close() // Copy _, err = io.Copy(dst, src) if err != nil { return err } return c.HTML(http.StatusOK, "<b>Thank you! " + name + "</b>")}同样的，我们使用 curl 命令在控制台执行下面的命令模拟文件上传请求：
Terminal
$ curl -F "name=Joe Smith" -F "avatar=@/path/to/your/avatar.png" http://localhost:1324/save// => <b>Thank you! Joe Smith</b>要检查上传的图片，请运行以下命令：
Terminal
$ cd <project directory>$ ls avatar.png// => avatar.png处理请求
- 调用方法
Context#Bind，Slim 会根据请求标头Content-Type的值，将提交的json、xml、form、query、header等数据绑定到 Go 结构中； - 响应 HTTP 状态码，并渲染
json、xml或其它格式的数据。
请求处理程序
type User struct { Name string `json:"name" xml:"name" form:"name" query:"name"` Email string `json:"email" xml:"email" form:"email" query:"email"`}e.POST("/users", func(c slim.Context) error { u := new(User) if err := c.Bind(u); err != nil { return err } return c.JSON(http.StatusCreated, u) // 或者 // return c.XML(http.StatusCreated, u)})静态内容
为路径 /static/ 提供静态文件服务。
静态服务路由
s.Static("/static", "static")模板渲染
需要提前实现模板渲染接口。
中间件
中间件示例
package mainimport ( "go-slim.dev/slim" "go-slim.dev/slim/middleware")func main() { s := slim.New() // Root level middleware s.Use(middleware.Logger()) s.Use(middleware.Recovery()) // Group level middleware s.Group("/admin", func(r slim.RouteCollector) { r.Use(middleware.BasicAuth(func(username, password string, c slim.Context) (bool, error) { if username == "joe" && password == "secret" { return true, nil } return false, nil })) }) // Route level middleware track := func(c slim.Context, next slim.HandlerFunc) error { println("request to /users") return next(c) } route := s.GET("/users", func(c slim.Context) error { return c.String(http.StatusOK, "/users") }) route.Use(track) // ... business logic log.Fatal(s.Start(":1324"))}Tip
如果您使用过其它 Web 框架，比如：chi、echo、gin 等，虽然具有相同的路由组概念，但却有本质上的区别：
- 这些框架的在路由声明期间，会将路由组的中间件复制并合并到路由上面，在路由声明完成后，路由组会被抛弃。
- 而我们路由组会与路由器及路由形成树形结构，在处理请求期间，会自上而下传递请求，之后过滤并逆序返回响应， 基于此，实现了友好的符合直观思维的洋葱模型。