響應

在 Hyperf 裏可通過 Hyperf\HttpServer\Contract\ResponseInterface 接口類來注入 Response 代理對象對響應進行處理，默認返回 Hyperf\HttpServer\Response 對象，該對象可直接調用所有 Psr\Http\Message\ResponseInterface 的方法。

注意 PSR-7 標準為響應(Response) 進行了 immutable 機制的設計，所有以 with 開頭的方法的返回值都是一個新對象，不會修改原對象的值

返回 Json 格式

Hyperf\HttpServer\Contract\ResponseInterface 提供了 json($data) 方法用於快速返回 Json 格式，並設置 Content-Type 為 application/json，$data 接受一個數組或為一個實現了 Hyperf\Utils\Contracts\Arrayable 接口的對象。

<?php
namespace App\Controller;

use Hyperf\HttpServer\Contract\ResponseInterface;
use Psr\Http\Message\ResponseInterface as Psr7ResponseInterface;

class IndexController
{
    public function json(ResponseInterface $response): Psr7ResponseInterface
    {
        $data = [
            'key' => 'value'
        ];
        return $response->json($data);
    }
}

返回 Xml 格式

Hyperf\HttpServer\Contract\ResponseInterface 提供了 xml($data) 方法用於快速返回 XML 格式，並設置 Content-Type 為 application/xml，$data 接受一個數組或為一個實現了 Hyperf\Utils\Contracts\Xmlable 接口的對象。

<?php
namespace App\Controller;

use Hyperf\HttpServer\Contract\ResponseInterface;
use Psr\Http\Message\ResponseInterface as Psr7ResponseInterface;

class IndexController
{
    public function xml(ResponseInterface $response): Psr7ResponseInterface
    {
        $data = [
            'key' => 'value'
        ];
        return $response->xml($data);
    }
}

返回 Raw 格式

Hyperf\HttpServer\Contract\ResponseInterface 提供了 raw($data) 方法用於快速返回 raw 格式，並設置 Content-Type 為 plain/text，$data 接受一個字符串或為一個實現了 __toString() 方法的對象。

<?php
namespace App\Controller;

use Hyperf\HttpServer\Contract\ResponseInterface;
use Psr\Http\Message\ResponseInterface as Psr7ResponseInterface;

class IndexController
{
    public function raw(ResponseInterface $response): Psr7ResponseInterface
    {
        return $response->raw('Hello Hyperf.');
    }
}

返回視圖

請參考視圖部分文檔

重定向

Hyperf\HttpServer\Contract\ResponseInterface 提供了 redirect(string $toUrl, int $status = 302, string $schema = 'http') 返回一個已設置重定向狀態的 Psr7ResponseInterface 對象。

redirect 方法：

參數	類型	默認值	備註
toUrl	string	無	如果參數不存在 `http://` 或 `https://` 則根據當前服務的 Host 自動拼接對應的 URL，且根據 `$schema` 參數拼接協議
status	int	302	響應狀態碼
schema	string	http	當 `$toUrl` 不存在 `http://` 或 `https://` 時生效，僅可傳遞 `http` 或 `https`

<?php
namespace App\Controller;

use Hyperf\HttpServer\Contract\ResponseInterface;
use Psr\Http\Message\ResponseInterface as Psr7ResponseInterface;

class IndexController
{
    public function redirect(ResponseInterface $response): Psr7ResponseInterface
    {
        // redirect() 方法返回的是一個 Psr\Http\Message\ResponseInterface 對象，需再 return 回去  
        return $response->redirect('/anotherUrl');
    }
}

<?php
namespace App\Controller;

use Hyperf\HttpServer\Contract\ResponseInterface;
use Psr\Http\Message\ResponseInterface as Psr7ResponseInterface;
use Hyperf\HttpMessage\Cookie\Cookie;

class IndexController
{
    public function cookie(ResponseInterface $response): Psr7ResponseInterface
    {
        $cookie = new Cookie('key', 'value');
        return $response->withCookie($cookie)->withContent('Hello Hyperf.');
    }
}

Gzip 壓縮

分塊傳輸編碼 Chunk

文件下載

Hyperf\HttpServer\Contract\ResponseInterface 提供了 download(string $file, string $name = '') 返回一個已設置下載文件狀態的 Psr7ResponseInterface 對象。
如果請求中帶有 if-match 或 if-none-match 的請求頭，Hyperf 也會根據協議標準與 ETag 進行比較，如果一致則會返回一個 304 狀態碼的響應。

download 方法：

參數	類型	默認值	備註
file	string	無	要返回下載文件的絕對路徑，同通過 BASE_PATH 常量來定位到項目的根目錄
name	string	無	客户端下載文件的文件名，為空則會使用下載文件的原名

<?php
namespace App\Controller;

use Hyperf\HttpServer\Contract\ResponseInterface;
use Psr\Http\Message\ResponseInterface as Psr7ResponseInterface;

class IndexController
{
    public function index(ResponseInterface $response): Psr7ResponseInterface
    {
        return $response->download(BASE_PATH . '/public/file.csv', 'filename.csv');
    }
}

5.5 KiB Raw Blame History Unescape Escape

響應