如何让Yii2返回不同HTTP响应？及关闭响应兼容FPDF/TCPDF

我来帮你解决这两个Yii2开发中的问题，都是类库开发和第三方PDF库集成时常见的场景：

1. 让Yii2返回不同HTTP响应的实现方法 #

在Yii2里，所有响应都是通过Yii::$app->response对象来管理的，对于类库开发来说，你可以直接操作这个对象，或者返回特定的响应组件实例，下面是几种常见场景的实现方式：

• 返回JSON响应
  直接设置响应格式为JSON，然后返回数据即可，类库中用这个方式很方便：

  use yii\web\Response;
  
  // 在类库方法中
  Yii::$app->response->format = Response::FORMAT_JSON;
  return [
      'code' => 200,
      'message' => 'Success',
      'data' => ['id' => 1, 'name' => 'Test']
  ];
  

  或者用更简洁的链式调用：

  return Yii::$app->response->asJson([
      'code' => 200,
      'message' => 'Success',
      'data' => ['id' => 1, 'name' => 'Test']
  ]);
  

• 返回XML响应
  和JSON的逻辑完全一致，只是格式换成XML：

  use yii\web\Response;
  
  Yii::$app->response->format = Response::FORMAT_XML;
  return [
      'code' => 200,
      'message' => 'Success',
      'data' => ['id' => 1, 'name' => 'Test']
  ];
  

  或者用asXml()快捷方法：

  return Yii::$app->response->asXml([
      'code' => 200,
      'message' => 'Success',
      'data' => ['id' => 1, 'name' => 'Test']
  ]);
  

• 返回自定义HTTP状态码
  如果需要返回404、500这类状态码，直接给响应对象设置statusCode就行：

  use yii\web\Response;
  
  Yii::$app->response->statusCode = 404;
  Yii::$app->response->format = Response::FORMAT_JSON;
  return ['message' => 'Resource not found'];
  

• 返回文件下载响应
  类库中要提供文件下载的话，用sendFile()方法一步到位：

  return Yii::$app->response->sendFile('/path/to/file.pdf', 'downloaded.pdf');
  

• 返回纯文本响应
  要是需要输出纯文本，设置响应为RAW格式并指定Content-Type：

  use yii\web\Response;
  
  Yii::$app->response->format = Response::FORMAT_RAW;
  Yii::$app->response->headers->set('Content-Type', 'text/plain');
  return 'Hello World';
  

2. 解决FPDF/TCPDF与Yii2响应冲突的问题 #

你遇到的HeadersAlreadySentException是因为Yii2的响应组件已经开始发送HTTP头了，而FPDF/TCPDF又要自己输出内容，导致头信息重复发送。解决这个问题的核心是阻止Yii2发送默认响应，让PDF类直接接管输出流程，下面是两种可靠的方法：

方法一：直接终止Yii2的响应流程 #

这种方法最直接，适合不需要Yii2后续处理的场景：

use yii\web\Response;

// 1. 禁用Yii2自动发送响应，只准备响应但不输出
Yii::$app->response->format = Response::FORMAT_RAW;
Yii::$app->response->send(false); // 参数false表示不发送响应

// 2. 初始化并生成PDF内容（这里以FPDF为例，TCPDF逻辑完全一致）
$pdf = new \FPDF();
$pdf->AddPage();
$pdf->SetFont('Arial','B',16);
$pdf->Cell(40,10,'Hello World!');

// 3. 让PDF直接输出到客户端
$pdf->Output();

// 4. 终止Yii2应用，防止后续代码继续执行
Yii::$app->end();

方法二：用Yii2响应组件包裹PDF输出 #

如果你想利用Yii2的响应管理（比如统一处理头信息），可以捕获PDF的输出内容，再通过Yii2响应发送：

use yii\web\Response;

// 1. 初始化并生成PDF
$pdf = new \FPDF();
$pdf->AddPage();
$pdf->SetFont('Arial','B',16);
$pdf->Cell(40,10,'Hello World!');

// 2. 捕获PDF的输出内容（'S'参数表示返回内容而不直接输出）
ob_start();
$pdfContent = $pdf->Output('S');
ob_end_clean();

// 3. 设置Yii2响应为PDF格式并发送
$response = Yii::$app->response;
$response->format = Response::FORMAT_RAW;
$response->headers->set('Content-Type', 'application/pdf');
$response->headers->set('Content-Disposition', 'inline; filename="output.pdf"'); // 可以改成attachment实现下载
$response->content = $pdfContent;
return $response;

关键注意事项 #

• 确保在调用PDF的Output()方法之前，没有任何echo、print或者意外的输出（比如PHP文件末尾的空格、换行符），这些都会触发头信息提前发送。
• 如果你的控制器开启了布局，记得先关闭：$this->layout = false;，避免布局的HTML内容干扰PDF输出。

内容的提问来源于stack exchange，提问作者robsch