- Documentación
- SDK PHP · Versión 0.1
- Pruebas y transportes
Pruebas y transportes
En esta página
El SDK envía cada petición mediante un transporte: CurlTransport por defecto, FakeTransport en tus pruebas, o una clase propia. Esta página muestra cómo probar una integración sin tocar la red, y cómo ajustar o sustituir el transporte.
FakeTransport
QuietSocial\Sdk\Testing\FakeTransport responde con respuestas programadas y registra cada petición. Una petición a la que ya nada responde hace fallar la prueba en lugar de salir a la red.
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' => 'Ejemplo', '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('Hola')->reference('articulo:42'), to: ['linkedin']);
$transport->assertSentCount(2); // GET /destinations, luego 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'), 'articulo:42:'));
Las respuestas en cola se usan primero, en orden; después, la función dada a respondUsing(), si la hay.
| Método | Uso |
|---|---|
push(int $status, array|string $body = [], array $headers = []) |
Pone una respuesta en cola; un cuerpo de tipo array se envía como JSON. |
respondUsing(callable $responder) |
Responde a toda petición que la cola no cubre: fn (Request $request): Response. |
requests() |
Todas las peticiones enviadas hasta ahora, en orden. |
assertSent(callable $check) |
Al menos una petición cumple la comprobación. |
assertSentCount(int $count) |
Se enviaron exactamente estas peticiones. |
assertNothingSent() |
No se envió ninguna petición. |
Las aserciones pasan por PHPUnit cuando está instalado, y lanzan una LogicException en caso contrario. Una Request expone method, url, path(), query(), header(), json() y, para un envío de archivo, part('file').
Simular un rechazo
Un rechazo se programa como cualquier respuesta: el SDK lo traduce exactamente como traduciría uno de la API.
use QuietSocial\Sdk\Exceptions\RateLimited;
$transport = (new FakeTransport)->push(429, ['message' => 'Demasiadas peticiones.'], ['Retry-After' => '17']);
$client = new Client('qsc_test', 'qss_test', transport: $transport);
try {
$client->publications()->find('pub_1');
} catch (RateLimited $limite) {
$limite->retryAfterSeconds; // 17
}
Las imágenes en las pruebas
Prefiere Image::fromContents() o Image::existing() a Image::fromUrl(): la dirección de una URL se comprueba contra el DNS antes de que nada llegue al transporte, y una dirección local se rechaza. Una imagen dada por su contenido sale como un envío POST /media, que se programa como las demás respuestas.
CurlTransport
El transporte por defecto usa cURL. Verifica los certificados, solo habla HTTP y HTTPS, nunca sigue por sí mismo una redirección, y rechaza sobre la marcha una respuesta mayor que su límite (SocialException con el código response_too_large). Sus límites se ajustan:
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 y timeout van en segundos; maxResponseBytes vale 20 MiB por defecto y se aplica también a las imágenes descargadas.
Un transporte propio
Cualquier clase que implemente QuietSocial\Sdk\Http\Transport puede sustituir a CurlTransport, para registrar las peticiones o pasar por tu propio cliente HTTP. Un transporte envía una petición y devuelve la Response, sea cual sea su estado: nunca convierte un 404 o un 500 en excepción, y solo lanza ServiceUnavailable cuando no volvió ninguna respuesta.
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));
Una petición lleva la cabecera Authorization: no registres nunca las cabeceras tal cual. Las descargas de imágenes llevan además dos indicaciones de conexión, pinnedAddress (la dirección comprobada) y bypassProxy. CurlTransport las respeta; un transporte propio que las ignore renuncia a la protección contra el DNS rebinding descrita en Imágenes.