- Documentation
- SDK PHP · Version 0.1
- Tests et transports
Tests et transports
Sur cette page
Le SDK envoie chaque requête par un transport : CurlTransport par défaut, FakeTransport dans vos tests, ou une classe à vous. Cette page montre comment tester une intégration sans toucher au réseau, et comment régler ou remplacer le transport.
FakeTransport
QuietSocial\Sdk\Testing\FakeTransport répond par des réponses programmées et enregistre chaque requête. Une requête à laquelle plus rien ne répond fait échouer le test au lieu de partir sur le réseau.
use QuietSocial\Sdk\Client;
use QuietSocial\Sdk\Http\Request;
use QuietSocial\Sdk\Post;
use QuietSocial\Sdk\Testing\FakeTransport;
$transport = (new FakeTransport)
->push(200, ['data' => [['id' => 'dst_1', 'network' => 'linkedin', 'name' => 'Exemple', 'can_publish' => true]]])
->push(201, ['data' => ['id' => 'pub_1', 'status' => 'scheduled']]);
$client = new Client('qsc_test', 'qss_test', transport: $transport);
$publication = $client->publications()->create(Post::make('Bonjour')->reference('article:42'), to: ['linkedin']);
$transport->assertSentCount(2); // GET /destinations, puis POST /publications
$transport->assertSent(fn (Request $request): bool => $request->method === 'POST'
&& str_ends_with($request->path(), '/publications')
&& $request->json()['destination_ids'] === ['dst_1']
&& str_starts_with((string) $request->header('Idempotency-Key'), 'article:42:'));
Les réponses en file servent d'abord, dans l'ordre ; ensuite, la fonction donnée à respondUsing(), s'il y en a une.
| Méthode | Usage |
|---|---|
push(int $status, array|string $body = [], array $headers = []) |
Met une réponse en file ; un corps tableau part en JSON. |
respondUsing(callable $responder) |
Répond à toute requête que la file ne couvre pas : fn (Request $request): Response. |
requests() |
Toutes les requêtes envoyées jusqu'ici, dans l'ordre. |
assertSent(callable $check) |
Au moins une requête satisfait la vérification. |
assertSentCount(int $count) |
Exactement ce nombre de requêtes est parti. |
assertNothingSent() |
Aucune requête n'est partie. |
Les assertions passent par PHPUnit quand il est installé, et lèvent une LogicException sinon. Une Request expose method, url, path(), query(), header(), json() et, pour un envoi de fichier, part('file').
Simuler un refus
Un refus se programme comme une réponse : le SDK le traduit exactement comme il traduirait celui de l'API.
use QuietSocial\Sdk\Exceptions\RateLimited;
$transport = (new FakeTransport)->push(429, ['message' => 'Too many requests.'], ['Retry-After' => '17']);
$client = new Client('qsc_test', 'qss_test', transport: $transport);
try {
$client->publications()->find('pub_1');
} catch (RateLimited $limite) {
$limite->retryAfterSeconds; // 17
}
Les images en test
Préférez Image::fromContents() ou Image::existing() à Image::fromUrl() : l'adresse d'une URL est vérifiée auprès du DNS avant que quoi que ce soit n'atteigne le transport, et une adresse locale est refusée. Une image donnée par son contenu part comme un envoi POST /media, à programmer comme les autres réponses.
CurlTransport
Le transport par défaut utilise cURL. Il vérifie les certificats, ne parle que HTTP et HTTPS, ne suit jamais lui-même une redirection, et refuse en cours de route une réponse plus grosse que sa limite (SocialException de code response_too_large). Ses limites se règlent :
use QuietSocial\Sdk\Http\CurlTransport;
$client = new Client(
clientId: 'qsc_a1b2c3d4e5f6g7h8i9j0k1l2',
clientSecret: (string) getenv('QUIET_SOCIAL_SECRET'),
transport: new CurlTransport(connectTimeout: 5, timeout: 20, maxResponseBytes: 20 * 1024 * 1024),
);
connectTimeout et timeout sont en secondes ; maxResponseBytes vaut 20 Mio par défaut et s'applique aussi aux images téléchargées.
Un transport personnalisé
Toute classe qui implémente QuietSocial\Sdk\Http\Transport peut remplacer CurlTransport, pour journaliser ou pour passer par votre propre client HTTP. Un transport envoie une requête et rend la Response, quel que soit son statut : il ne transforme jamais un 404 ou un 500 en exception, et ne lève ServiceUnavailable que lorsqu'aucune réponse n'est revenue.
use QuietSocial\Sdk\Http\Request;
use QuietSocial\Sdk\Http\Response;
use QuietSocial\Sdk\Http\Transport;
final class LoggingTransport implements Transport
{
public function __construct(private readonly Transport $inner) {}
public function send(Request $request): Response
{
$response = $this->inner->send($request);
error_log(sprintf('%s %s: %d', $request->method, parse_url($request->url, PHP_URL_HOST), $response->status));
return $response;
}
}
$client = new Client('qsc_…', (string) getenv('QUIET_SOCIAL_SECRET'), transport: new LoggingTransport(new CurlTransport));
Une requête porte l'en-tête Authorization : ne journalisez jamais les en-têtes tels quels. Les téléchargements d'images portent aussi deux indications de connexion, pinnedAddress (l'adresse vérifiée) et bypassProxy. CurlTransport les respecte ; un transport à vous qui les ignore renonce à la protection contre le rebinding DNS décrite dans Images.