信息发布→ 登录 注册 退出

thinkphp跨域请求(CORS)如何配置

发布时间:2025-09-25

点击量:
推荐使用中间件配置跨域,TP6通过创建CorsMiddleware设置响应头并拦截OPTIONS请求返回204状态码,TP5可在基类控制器中统一添加header,也可用Response对象或Nginx配置实现,关键在于正确处理预检请求。

ThinkPHP 实现跨域请求(CORS)主要通过设置响应头来允许浏览器进行跨域访问。以下是 ThinkPHP 5 和 ThinkPHP 6 的常见配置方式,适用于前后端分离项目。

1. 全局中间件配置(推荐,TP6)

在 ThinkPHP 6 中,推荐使用中间件统一处理 CORS 请求。

步骤:

  • 创建中间件:执行命令 php think make:middleware CorsMiddleware
  • 编辑中间件文件 app/middleware/CorsMiddleware.php

写入以下内容:

public function handle($request, \Closure $next)
{
    header('Access-Control-Allow-Origin: *');
    header('Access-Control-Allow-Credentials: true');
    header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS');
    header('Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With');

    if ($request->isOptions()) {
        return response('', 204);
    }

    return $next($request);
}

注册中间件:在 app/middleware.php 中添加:

return [
    // 其他中间件
    \app\middleware\CorsMiddleware::class,
];

2. 在控制器中手动设置(适用于 TP5 或简单场景)

如果你使用的是 ThinkPHP 5 或只需要在某些接口开启跨域,可以在控制器的初始化方法中设置响应头。

示例代码:

namespace app\controller;

use think\Controller;
use think\Response;

class BaseController extends Controller
{
    public function initialize()
    {
        header('Access-Control-Allow-Origin: *');
        header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE');
        header('Access-Control-Allow-Headers: Content-Type, Authorization');

        if (request()->isOptions()) {
            exit();
        }
    }
}

让其他控制器继承 BaseController 即可自动支持跨域。

3. 使用 Response 对象返回(更规范)

在实际接口返回时,可以通过设置 Response 头部实现跨域。

示例:

return json(['status' => 'success'])
    ->header([
        'Access-Control-Allow-Origin'      => '*',
        'Access-Control-Allow-Methods'     => 'GET, POST, PUT, DELETE',
        'Access-Control-Allow-Headers'     => 'Content-Type, Authorization',
    ])

4. Nginx 配置跨域(非 PHP 层)

如果希望由服务器直接处理跨域,可在 Nginx 配置中添加头部,适合生产环境。

在 server 块中加入:

add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, PUT, DELETE, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization, X-Requested-With';

注意:Nginx 方式更高效,但灵活性不如 PHP 层控制。

基本上就这些。根据你的 ThinkPHP 版本选择合适的方式,推荐 TP6 使用中间件,TP5 可用基类控制器统一处理。关键是拦截 OPTIONS 预检请求并正确返回 204 状态码。不复杂但容易忽略。

标签:# 继承  # 关键在于  # 头来  # 只需要  # 可以通过  # 如果你  # 中统  # 的是  # 可在  # 适用于  # 推荐使用  # 对象  # 接口  # php  # 中间件  # red  # 状态码  # 跨域  # 后端  # access  # app  # 浏览器  # nginx  # json  # js  # thinkphp  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!