php vcr

Это порт библиотеки VCR Ruby на PHP.

Записывайте HTTP-взаимодействия вашего набора тестов и воспроизводите их во время будущих запусков тестов для быстрых, детерминированных и точных тестов. Небольшую документацию можно найти на сайте php-vcr.

Отказ от ответственности: сделать это в PHP не так просто, как в языках программирования, которые поддерживают обезьяньи исправления (я смотрю на тебя, Руби).

Функции

• Автоматически записывает и воспроизводит ваши HTTP-взаимодействия с минимальным использованием кода установки/конфигурации.
• Поддерживает распространенные функции и расширения HTTP.
  • все, используяstreamWrapper: fopen(), fread(), file_get_contents(), ... без каких-либо изменений (кроме $http_response_header , см. #96)
  • SoapClient, добавив VCRVCR::turnOn(); в ваших tests/bootstrap.php
  • curl(), добавив VCRVCR::turnOn(); в ваших tests/bootstrap.php
• Один и тот же запрос может получить разные ответы в разных тестах — просто используйте разные кассеты.
• Отключает все HTTP-запросы, которые вы явно не разрешаете, устанавливая режим записи.
• Сопоставление запросов можно настроить на основе метода HTTP, URI, хоста, пути, тела и заголовков, или вы можете легко реализовать собственное средство сопоставления запросов для удовлетворения любых потребностей.
• Записанные запросы и ответы сохраняются на диске в выбранном вами формате сериализации (в настоящее время YAML и JSON встроены, и вы можете легко реализовать свой собственный сериализатор).
• Поддерживает аннотации PHPUnit.

Пример использования

Использование вызовов статических методов:

 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 ' );
    }
}

Вы можете использовать аннотации в PHPUnit, используя 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.
    }
}

Установка

Просто запустите следующую команду:

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

Зависимости

PHP-VCR зависит от:

• PHP 8
• Расширение локонов
• Symfony/диспетчер событий
• Симфония/Ямл
• Беберлей/утверждать

Composer устанавливает все зависимости, кроме расширений, таких как Curl.

Запуск тестов

Чтобы запустить все тесты, вам необходимо получить зависимости разработки с помощью композитора:

composer install
composer test

Журнал изменений

Журнал изменений перемещен на страницу выпусков PHP-VCR.

Старые записи журнала изменений

Авторское право

Copyright (c) 2013–2023 Адриан Филипп. Выпущено на условиях лицензии MIT. Подробности см. в разделе ЛИЦЕНЗИЯ. Авторы