Swoole的Http\Response对象用于发送HTTP响应,常用方法包括:1. header()设置响应头;2. status()修改状态码;3. cookie()写入Cookie;4. write()分段输出、end()结束响应;5. gzip()启用压缩;6. redirect()重定向;7. detach()和upgrade()用于WebSocket升级。需注意调用顺序与限制。

Swoole 的 Http\Response 对象用于在 Swoole HTTP 服务器中向客户端发送响应。它封装了响应头、状态码、正文等信息,提供了多个实用方法来控制输出内容和行为。以下是常用的 Http\Response 方法及其用途说明。
1. header() - 设置响应头
用于添加或修改 HTTP 响应头字段,比如 Content-Type、Cookie 等。
- 格式:header(string $key, string $value, bool $replace = true)- 示例:
$response->header("Content-Type", "application/json");$response->header("X-Powered-By", "Swoole");注意:必须在 end() 之前调用,且不能重复设置相同键(除非 replace 为 true)。
2. status() - 设置 HTTP 状态码
自定义响应的 HTTP 状态码,如 404、500 等。
- 格式:status(int $code)- 示例:
$response->status(404);$response->status(500);默认是 200,调用该方法可更改状态码。需在 end() 前设置。
3. cookie() - 设置 Cookie
向客户端写入 Cookie,支持设置路径、域、有效期等参数。
- 格式:cookie(string $name, string $value = '', int $expires = 0, string $path = "/", string $domain = "", bool $secure = false, bool $httponly = false)- 示例:
$response->cookie("user_id", "123", time() + 3600, "/");常用于会话管理或用户识别。
4. write() 和 end() - 输出响应内容
write() 用于分段输出内容,适用于大文件或流式传输;end() 结束响应并发送最终内容。
-write(string $data):追加数据到响应体-
end(string $data = ""):结束响应,可带最后的数据
示例:
$response->write("Hello");$response->write(" World");$response->end("!");使用 write() 可实现 chunked 输出,end() 必须调用一次且只能一次。
5. gzip() - 启用 GZIP 压缩
对响应内容启用 GZIP 压缩,减少传输体积。
- 格式:gzip(int $level = 6)- 示例:
$response->gzip(); // 默认压缩级别 6$response->gzip(9); // 最高压缩客户端需支持 Accept-Encoding: gzip 才会生效。
6. redirect() - 重定向
发送 302 或其他类型的跳转响应。
- 格式:redirect(string $location, int $http_code = 302)- 示例:
$response->redirect("/login", 302);自动设置 Location 头并结束响应。
7. detach() 和 upgrade() - 高级用法
detach() 将连接从当前请求分离,用于长连接或 WebSocket 升级前操作。
upgrade() 用于将 HTTP 连接升级为 WebSocket 连接。
if ($server->isUpgrade) { $response->upgrade(); }基本上就这些常用方法。掌握它们可以灵活控制 Swoole 中的 HTTP 响应行为,构建高性能 Web 服务或 API 接口时不复杂但容易忽略细节。










