README

webclient/fake-http-client

PSR-18 HTTP 客户端的模拟

安装

将包添加到项目中

composer require --dev webclient/fake-http-client:^3.0

设置自动加载

<?php

include 'vendor/autoload.php';

使用

<?php

use Webclient\Fake\FakeHttpClient;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Server\RequestHandlerInterface;

/** 
 * @var RequestHandlerInterface $handler your mock handler 
 * @var RequestInterface $request your tested request
 */
$client = new FakeHttpClient($handler);

$response = $client->sendRequest($request);

处理器

SpecHandler

此包提供通用的处理器 \Webclient\Fake\Handler\SpecHandler\SpecHandler 和构建器 \Webclient\Fake\Handler\SpecHandler\SpecHandlerBuilder。使用它，您可以为几乎任何需求定制客户端。

<?php

use Psr\Http\Message\ResponseInterface;
use Webclient\Fake\FakeHttpClient;
use Webclient\Fake\Handler\SpecHandler\SpecHandlerBuilder;
use Webclient\Fake\Handler\SpecHandler\Rule;

$builder = SpecHandlerBuilder::create();

$builder
    ->route(function (Rule $rule) {
        $rule->notEqual('header.authorization', 'bearer xxx');
        $rule->oneOf(function (Rule $rule) {
            $rule->allOf(function (Rule $rule) {
                $rule->equal('uri.path', '/api/v1/posts');
                $rule->equal('method', 'POST');
            });
            $rule->allOf(function (Rule $rule) {
                $rule->match('uri.path', '^/api/v1/posts/([a-zA-Z0-9\-]+)$');
                $rule->match('method', '^(PUT|DELETE)$');
            });
        });
    })
    ->response(function (ResponseInterface $response): ResponseInterface {
        return $response->withStatus(403);
    });

$handler = $builder->build();

$client = new FakeHttpClient($handler);

SimpleRoutingHandler

此包提供简单路由。

<?php

use Webclient\Fake\FakeHttpClient;
use Webclient\Fake\Handler\SimpleRoutingHandler\SimpleRoutingHandler;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Server\RequestHandlerInterface;

/** 
 * @var RequestHandlerInterface $notFoundHandler default handler, error 404
 * @var RequestHandlerInterface $entityCreatedHandler handler for 201 request (POST /entities) 
 * @var RequestHandlerInterface $entityHandler handler for 200 request (GET /entities/1)
 * @var RequestHandlerInterface $entityDeletedHandler handler for 204 request (DELETE /entities/2)
 * @var RequestInterface $errorRequest request for unused uri (GET /users)
 * @var RequestInterface $entityCreatingRequest request for creating entity (POST /entities)
 * @var RequestInterface $entityRequest request for getting entity (GET /entities/1)
 * @var RequestInterface $entityDeletingRequest request for deleting entity (DELETE /entities/2)
 */

$handler = new SimpleRoutingHandler($notFoundHandler);
$handler
    ->route(['GET', 'HEAD'], '/entities/1', $entityHandler)
    ->route(['POST'], '/entities', $entityCreatedHandler)
    ->route(['DELETED'], '/entities/2', $entityDeletedHandler)
;
$client = new FakeHttpClient($handler);

$response1 = $client->sendRequest($errorRequest); // returns error 404
$response2 = $client->sendRequest($entityCreatingRequest); // returns success response 201
$response3 = $client->sendRequest($entityRequest); // returns success response 200
$response4 = $client->sendRequest($entityDeletingRequest); // returns success response 204

细节

如果您将 \Psr\Http\Message\ServerRequestInterface 对象传递给客户端，并希望处理器以原始形式接收它，请添加属性 \Webclient\Fake\Client::NO_REPLACE_ATTRIBUTE

<?php

use Webclient\Fake\FakeHttpClient;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\RequestHandlerInterface;

/** 
 * @var RequestHandlerInterface $handler your mock handler 
 * @var ServerRequestInterface $request your tested request
 */
$client = new FakeHttpClient($handler);

$response = $client->sendRequest($request->withAttribute(FakeHttpClient::NO_REPLACE_ATTRIBUTE, true));