PSR-7 和值对象

编辑此页面

Slim 为其请求和响应对象支持 PSR-7 接口。这让 Slim 变得灵活，因为它可以使用任何PSR-7 实现。例如，你可以返回 GuzzleHttp\Psr7\CachingStream 实例或 GuzzleHttp\Psr7\stream_for() 函数返回的任何实例。

Slim 提供了自己的 PSR-7 实现。不过，你可以自由地安装第三方实现。

值对象

请求和响应对象是不可变值对象。仅通过请求一个具有更新属性值的克隆版本才能“更改”它们。值对象有标称开销，因为更新其属性时必须克隆它们。这种开销不会以任何有意义的方式影响性能。

可以通过调用任何 PSR-7 接口方法来请求值对象的副本（这些方法通常具有 with 前缀）。例如，PSR-7 响应对象具有 withHeader($name, $value) 方法，该方法返回一个具有新 HTTP 标头的克隆值对象。

<?php

use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Slim\Factory\AppFactory;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

$app->get('/foo', function (Request $request, Response $response, array $args) {
    $payload = json_encode(['hello' => 'world'], JSON_PRETTY_PRINT);
    $response->getBody()->write($payload);
    return $response->withHeader('Content-Type', 'application/json');
});

$app->run();

PSR-7 接口提供这些方法来转换请求和响应对象

  • withProtocolVersion($version)
  • withHeader($name, $value)
  • withAddedHeader($name, $value)
  • withoutHeader($name)
  • withBody(StreamInterface $body)

PSR-7 接口提供这些方法来转换请求对象

  • withMethod($method)
  • withUri(UriInterface $uri, $preserveHost = false)
  • withCookieParams(array $cookies)
  • withQueryParams(array $query)
  • withUploadedFiles(array $uploadedFiles)
  • withParsedBody($data)
  • withAttribute($name, $value)
  • withoutAttribute($name)

PSR-7 接口提供这些方法来转换响应对象

  • withStatus($code, $reasonPhrase = '')

有关这些方法的详细信息，请参见PSR-7 文档。