Skip to content

v2.7.0 — quem usa a biblioteca passa a conseguir testar

Choose a tag to compare

@mariolucasdev mariolucasdev released this 24 Oct 19:56
· 14 commits to develop since this release
0e6d2e8

Uma mudança só, e ela é para quem usa a biblioteca, não para quem a mantém.

Testar sem sair para a rede

A suíte do PHPay injeta Client em cada Resource, e os construtores aceitam ?Client $client justamente para isso. Mas quem consome a biblioteca não constrói Resource: recebe o gateway montado, sobretudo resolvendo por nome. E o registry não aceita Client.

Resultado até aqui: uma aplicação que usasse o PHPay não escrevia teste de controller, de listener de webhook nem de job sem falar com o gateway de verdade.

use PHPay\Http\ClientFactory;

ClientFactory::fake([
    new Response(200, [], json_encode(['id' => 'pay_001', 'status' => 'PENDING'])),
]);

/* o código da aplicação roda igual, sem saber que está em teste */
$pedido->pagar();

ClientFactory::recorded();   // o que ele mandou
ClientFactory::stopFaking();
Membro
fake($respostas) daqui em diante, todo client montado responde da fila
faking() se está em modo falso
recorded() as requisições que a aplicação fez
stopFaking() volta ao normal e limpa o histórico

Por que na fábrica

Aceitar Client no registry era o caminho óbvio, e o levantamento o descartou: quatro gateways têm mais de um client.

Gateway Clients
Efí Cobranças + API Pix
Cielo escritas + consultas
Rede transações + host de OAuth

Um client só falsearia metade. Na Rede seria pior: ela pede token antes de cada chamada, num host separado, então a outra metade iria para a rede na primeira linha do teste.

Como toda a biblioteca monta client em ClientFactory::make() — 14 pontos de chamada, sem nenhum new Client( fora dela, e com teste varrendo src/ que reprova quem furar —, falsear ali alcança todos de uma vez. E nenhuma assinatura mudou: nem a do registry, nem a dos construtores.

Três coisas para não se machucar

O retry continua instalado. Falsear a rede não desliga a política que impede cobrança dupla — teste que queira exercitá-la põe duas respostas na fila.

Só request e options são gravados. Em modo falso as respostas são as que o seu teste enfileirou, então repeti-las não diz nada. O que o teste não sabe de antemão é a requisição.

É estado estático, com o mesmo contrato do Mail::fake() do Laravel: opt-in, e stopFaking() restaura. Desligue no teardown:

afterEach(fn () => ClientFactory::stopFaking());

Client injetado no construtor não é afetado, porque não passa pela fábrica — é o que mantém a suíte da própria biblioteca funcionando.

A página Testando cobre o resto, e o de-para completo está no CHANGELOG.