第 7 部分：RESTful API 中的跨域资源共享 (CORES)

2024-02-11 14:14:45

跨域资源共享 (CORS)：解锁跨域请求的奥秘

跨域资源共享 (CORS) 是一种强大的 HTTP 机制，它允许来自不同域、协议或源的客户端应用程序与服务器上的资源进行交互。通过使用额外的 HTTP 头部，例如 Origin 和 Access-Control-Allow-Origin，CORS 扩展了浏览器的同源策略，允许不同源的请求。

为什么要使用 CORS？

如果您在不同的域上构建客户端应用程序（例如基于浏览器的客户端或移动应用程序），并且希望访问托管在另一个域上的 REST API，那么您就需要 CORS。如果没有 CORS，浏览器将阻止客户端应用程序访问服务器资源，从而导致跨域错误。

如何实现 CORS？

在 IRIS 框架中实现 CORS 非常简单，只需以下三个步骤：

安装 iris-cors 包。

使用以下命令通过 go get 命令安装 iris-cors 包：
```
go get -u github.com/kataras/iris/v12/middleware/cors
```

配置 CORS 中间件。

在您的应用程序中，使用以下代码配置 CORS 中间件：

import (
    "github.com/kataras/iris/v12"
    "github.com/kataras/iris/v12/middleware/cors"
)

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

    // 允许所有来源
    app.Use(cors.Default())

    // 使用自定义选项
    app.Use(cors.New(cors.Options{
        AllowedOrigins:   []string{"https://example.com", "https://mydomain.com"},
        AllowedMethods:   []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"},
        AllowedHeaders:   []string{"Content-Type", "Authorization"},
        ExposedHeaders:   []string{"Content-Length", "Content-Range"},
        AllowCredentials: true,
        MaxAge:           600, // 600 秒
    }))

    app.Get("/", func(ctx iris.Context) {
        ctx.Writef("你好，世界！")
    })

    // 启动您的应用程序
    app.Run(iris.Addr(":8080"))
}

指定 CORS 选项。

New 函数接受一个 cors.Options 结构，允许您自定义 CORS 中间件的行为。以下是一些可用的选项：
- AllowedOrigins: 允许的来源列表
- AllowedMethods: 允许的方法列表
- AllowedHeaders: 允许的头信息列表
- ExposedHeaders: 公开头信息的列表
- AllowCredentials: 是否允许凭据（例如 cookie）
- MaxAge: 响应中 Access-Control-Max-Age 头部的值