php vcr

Este es un puerto de la biblioteca VCR Ruby a PHP.

Registre las interacciones HTTP de su conjunto de pruebas y reprodúzcalas durante futuras ejecuciones de pruebas para realizar pruebas rápidas, deterministas y precisas. Puede encontrar un poco de documentación en el sitio web de php-vcr.

Descargo de responsabilidad: hacer esto en PHP no es tan fácil como en los lenguajes de programación que admiten parches de mono (te estoy mirando, Ruby)

Características

• Graba y reproduce automáticamente sus interacciones HTTP con un código mínimo de instalación/configuración.
• Admite funciones y extensiones http comunes
  • todo usando streamWrapper: fopen(), fread(), file_get_contents(), ... sin ninguna modificación (excepto $http_response_header ver #96)
  • SoapClient agregando VCRVCR::turnOn(); en tus tests/bootstrap.php
  • curl(), agregando VCRVCR::turnOn(); en tus tests/bootstrap.php
• La misma solicitud puede recibir diferentes respuestas en diferentes pruebas, simplemente use casetes diferentes.
• Deshabilita todas las solicitudes HTTP que no permite explícitamente configurando el modo de grabación
• La coincidencia de solicitudes se puede configurar según el método HTTP, URI, host, ruta, cuerpo y encabezados, o puede implementar fácilmente un comparador de solicitudes personalizado para manejar cualquier necesidad.
• Las solicitudes y respuestas grabadas se almacenan en el disco en un formato de serialización de su elección (actualmente, YAML y JSON están integrados y puede implementar fácilmente su propio serializador personalizado).
• Admite anotaciones PHPUnit.

Ejemplo de uso

Usando llamadas a métodos estáticos:

 class VCRTest extends TestCase
{
    public function testShouldInterceptStreamWrapper ()
    {
        // After turning on the VCR will intercept all requests
         VCR  VCR :: turnOn ();

        // Record requests and responses in cassette file 'example'
         VCR  VCR :: insertCassette ( ' example ' );

        // Following request will be recorded once and replayed in future test runs
        $ result = file_get_contents ( ' http://example.com ' );
        $ this -> assertNotEmpty ( $ result );

        // To stop recording requests, eject the cassette
         VCR  VCR :: eject ();

        // Turn off VCR to stop intercepting requests
         VCR  VCR :: turnOff ();
    }

    public function testShouldThrowExceptionIfNoCasettePresent ()
    {
        $ this -> setExpectedException (
            ' BadMethodCallException ' ,
            " Invalid http request. No cassette inserted. Please make sure to insert "
            . " a cassette in your unit test using VCR::insertCassette('name'); "
        );
         VCR  VCR :: turnOn ();
        // If there is no cassette inserted, a request throws an exception
        file_get_contents ( ' http://example.com ' );
    }
}

Puedes usar anotaciones en PHPUnit usando phpunit-testlistener-vcr:

 class VCRTest extends TestCase
{
    /**
     * @vcr unittest_annotation_test
     */
    public function testInterceptsWithAnnotations ()
    {
        // Requests are intercepted and stored into  tests/fixtures/unittest_annotation_test.
        $ result = file_get_contents ( ' http://google.com ' );

        $ this -> assertEquals ( ' This is a annotation test dummy. ' , $ result , ' Call was not intercepted (using annotations). ' );

        // VCR is automatically turned on and off.
    }
}

Instalación

Simplemente ejecute el siguiente comando:

$ composer require --dev php-vcr/php-vcr

Dependencias

PHP-VCR depende de:

• PHP 8
• extensión de rizo
• Symfony/despachador de eventos
• Symfony/yaml
• beberlei/afirmar

Composer instala todas las dependencias excepto extensiones como curl.

Ejecutar pruebas

Para ejecutar todas las pruebas, necesita obtener dependencias de desarrollo usando Composer:

composer install
composer test

Registro de cambios

El registro de cambios se ha movido a la página de lanzamientos de PHP-VCR.

Entradas antiguas del registro de cambios

Derechos de autor

Copyright (c) 2013-2023 Adrian Philipp. Publicado bajo los términos de la licencia MIT. Consulte LICENCIA para obtener más detalles. Colaboradores