igaster/php-vcr

记录您的测试套件的HTTP交互,并在未来的测试运行中回放它们,以实现快速、确定性和精确的测试。

1.5.4 2021-08-02 09:45 UTC

README

PHP-VCR

Build Status Code Coverage Scrutinizer Quality Score

这是将VCR Ruby库移植到PHP的一个例子。

记录您的测试套件的HTTP交互,并在未来的测试运行中回放它们,以实现快速、确定性和精确的测试。有关文档,请访问php-vcr网站

免责声明:在PHP中这样做并不像在支持猴子补丁的编程语言(我在看你,Ruby)中那样容易。

功能

  • 自动记录和回放您的HTTP(s)交互,配置和设置代码最少。
  • 支持常见的http功能和扩展
    • 使用streamWrapper的所有内容:fopen(),fread(),file_get_contents()等,无需任何修改(除了$http_response_header,见#96)
    • SoapClient通过在您的tests/bootstrap.php中添加\VCR\VCR::turnOn();实现
    • curl(),通过在您的tests/bootstrap.php中添加\VCR\VCR::turnOn();实现
  • 相同的请求可以在不同的测试中接收不同的响应 - 只需使用不同的磁带。
  • 通过设置记录模式禁用您未明确允许的所有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-testlistener-vcr在PHPUnit中使用注解

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依赖于以下内容

Composer安装所有依赖项,除了curl之类的扩展。

运行测试

要运行所有测试,您需要使用composer获取开发依赖项

composer install
composer test

变更日志

变更日志已移至PHP-VCR版本发布页面

旧版本变更日志条目

版权

版权所有(c)2013-2016 Adrian Philipp。在MIT许可的条款下发布。有关详细信息,请参阅LICENSE。贡献者