symfony中返回响应需用response类或其子类（如jsonresponse、redirectresponse）构造对象并由控制器返回；框架自动发送，无需手动调用send()；推荐使用常量设状态码、set()设响应头、jsonresponse处理api、专用类实现重定向与文件下载。
在 Symfony 中返回响应，核心是使用 Response 或其子类（如 JsonResponse、RedirectResponse）构造对象并由控制器返回。框架会自动发送该对象到客户端，无需手动调用 send()（仅在极少数脱离框架流程时才需显式调用）。
基础文本或 HTML 响应
最直接的方式是实例化 Response 类，传入内容、状态码和响应头：
- 内容可以是纯字符串、HTML 片段，甚至渲染后的模板内容
- 状态码推荐使用 Symfony 提供的常量（如
Response::HTTP_OK、Response::HTTP_NOT_FOUND），避免硬编码数字 - 响应头通过
$response->headers->set()设置，例如Content-Type、X-App-Version
示例：
use Symfony\Component\HttpFoundation\Response;public function homepage(): Response
{
$content = '
Welcome
';$response = new Response($content, Response::HTTP_OK);
$response->headers->set('Content-Type', 'text/html; charset=UTF-8');
return $response;
}
JSON 响应（API 场景常用）
对于 RESTful 接口，优先使用 JsonResponse —— 它自动完成 JSON 编码、设置 Content-Type: application/json，并默认启用安全转义选项：
- 传入数组或对象，它会调用
json_encode()并处理错误（如循环引用会抛出异常） - 支持链式调用：可接着设置状态码、头信息或缓存策略
- 若需自定义 JSON 选项（如
JSON_UNESCAPED_UNICODE），可传入第四个参数
示例：
use Symfony\Component\HttpFoundation\JsonResponse;public function apiUsers(): JsonResponse
{
$data = ['users' => [['id' => 1, 'name' => 'Alice']]];
return new JsonResponse($data, Response::HTTP_OK);
}
重定向与特殊响应类型
Symfony 提供了语义清晰的专用响应类，比手动构造更安全、更易读：
-
RedirectResponse：用于 301/302 跳转，自动设置Location头 -
StreamedResponse：适合大文件下载或实时流式输出，内容通过回调函数生成 -
BinaryFileResponse：专为文件下载设计，自动处理Content-Length、Content-Disposition和断点续传（Range） - 控制器中还可直接调用
$this->redirect()、$this->redirectToRoute()等快捷方法（需继承AbstractController）
响应头与缓存控制
响应头不是附加功能，而是影响客户端行为的关键部分。Symfony 的 Response 提供了便捷接口：
- 单个头：
$response->headers->set('X-Debug', 'true') - Cookie：
$response->headers->setCookie(new Cookie('session_id', 'abc123')) - 缓存策略：
$response->setCache(['max_age' => 3600, 'public' => true])，会自动设置Cache-Control和Expires - ETag / Last-Modified：
$response->setEtag(md5($content))或$response->setLastModified(new \DateTime('@'.filemtime($file)))
这些设置在返回前完成即可，框架会在发送时一并写入 HTTP 报文。
