Question

我正在尝试使用vfsStream来模拟文件系统操作（实际上是从php：//输入读取），但是缺乏合适的文档和示例实际上是在阻碍我。

我正在测试的类的相关代码如下：

class RequestBody implements iface\request\RequestBody
{
    const
        REQ_PATH    = 'php://input',

    protected
        $requestHandle  = false;

    /**
     * Obtain a handle to the request body
     * 
     * @return resource a file pointer resource on success, or <b>FALSE</b> on error.
     */
    protected function getHandle ()
    {
        if (empty ($this -> requestHandle))
        {
            $this -> requestHandle  = fopen (static::REQ_PATH, 'rb');
        }
        return $this -> requestHandle;
    }
}

我在PHPUnit测试中使用的设置如下：

protected function configureMock ()
{
    $mock   = $this -> getMockBuilder ('\gordian\reefknot\http\request\RequestBody');

    $mock   -> setConstructorArgs (array ($this -> getMock ('\gordian\reefknot\http\iface\Request')))
            -> setMethods (array ('getHandle'));


    return $mock;
}

/**
 * Sets up the fixture, for example, opens a network connection.
 * This method is called before a test is executed.
 */
protected function setUp ()
{
    \vfsStreamWrapper::register();
    \vfsStream::setup ('testReqBody');

    $mock   = $this -> configureMock ();
    $this -> object = $mock -> getMock ();

    $this -> object -> expects ($this -> any ())
                    -> method ('getHandle')
                    -> will ($this -> returnCallback (function () {
                        return fopen ('vfs://testReqBody/data', 'rb');
                    }));
}

在实际测试中（调用间接触发getHandle（）的方法）我尝试设置VFS并按如下方式运行断言：

public function testBodyParsedParsedTrue ()
{
    // Set up virtual data
    $fh     = fopen ('vfs://testReqBody/data', 'w');
    fwrite ($fh, 'test write 42');
    fclose ($fh);
    // Make assertion
    $this -> object -> methodThatTriggersGetHandle ();
    $this -> assertTrue ($this -> object -> methodToBeTested ());
}

这只会导致测试挂起。

显然我在这里做了一些非常错误的事情，但考虑到文档的状态，我无法弄清楚它是什么意思。这是由vfsstream引起的，还是phpunit嘲笑我需要在这里查看的东西？

Answer 1

那么......如何测试流？所有vfsStream都为文件系统操作提供了一个自定义流包装器。您不需要完整的vfsStream库来模拟单个流参数的行为 - 它不是正确的解决方案。相反，您需要编写和注册自己的一次性流包装器，因为您没有尝试模拟文件系统操作。

假设您要测试以下简单类：

class ClassThatNeedsStream {
    private $bodyStream;
    public function __construct($bodyStream) {
        $this->bodyStream = $bodyStream;
    }
    public function doSomethingWithStream() {
        return stream_get_contents($this->bodyStream);
    }
}

在现实生活中，你做了：

$phpInput = fopen('php://input', 'r');
new ClassThatNeedsStream($phpInput);

因此，为了测试它，我们创建了自己的流包装器，它允许我们控制我们传入的流的行为。我不能详细介绍，因为自定义流包装器是一个很大的主题。但是基本上这个过程是这样的：

创建自定义流包装器
使用PHP注册该流包装器
使用已注册的流包装器方案

所以你的自定义流看起来像：

class TestingStreamStub {

    public $context;
    public static $position = 0;
    public static $body = '';

    public function stream_open($path, $mode, $options, &$opened_path) {
        return true;
    }

    public function stream_read($bytes) {
        $chunk = substr(static::$body, static::$position, $bytes);
        static::$position += strlen($chunk);
        return $chunk;
    }

    public function stream_write($data) {
        return strlen($data);
    }

    public function stream_eof() {
        return static::$position >= strlen(static::$body);
    }

    public function stream_tell() {
        return static::$position;
    }

    public function stream_close() {
        return null;
    }
}

然后在你的测试用例中你会这样做：

public function testSomething() {
    stream_wrapper_register('streamTest', 'TestingStreamStub');
    TestingStreamStub::$body = 'my custom stream contents';
    $stubStream = fopen('streamTest://whatever', 'r+');

    $myClass = new ClassThatNeedsStream($stubStream);
    $this->assertEquals(
        'my custom stream contents',
        $myClass->doSomethingWithStream()
    );

    stream_wrapper_unregister('streamTest');
}

然后，您可以简单地更改我在流包装器中定义的静态属性，以更改从读取流中返回的数据。或者，扩展基本流包装器类并注册它，以便为测试提供不同的方案。

这是一个非常基本的介绍，但重点在于：除非你嘲笑实际的文件系统操作，否则不要使用vfsStream - 这就是它的设计目的。否则，编写自定义流包装器进行测试。

PHP提供了一个原型流包装器类来帮助您入门：http://www.php.net/manual/en/class.streamwrapper.php

Answer 2

我一直在寻找类似的答案 - 我发现文档也缺乏。

我怀疑您的问题是vfs://testReqBody/data不是现有文件的路径，（因为php://input始终是。）

如果接受的答案是可接受的答案，那么这与vfsStreamWrapper等效。

<?php
// ...
$reqBody = "Request body contents"
vfsStream::setup('testReqBody', null, ['data' => $reqBody]);
$this->assertSame($reqBody, file_get_contents('vfs://testReqBody/data'));

或者，如果您需要将其拆分，以便在调用vfsStream::setup()后定义内容，这就是方法。

<?php
//...
$reqBody = "Request body contents"
$vfsContainer = vfsStream::setup('testReqBody');
vfsStream::newFile('data')->at($vfsContainer)->setContent($reqBody);
$this->assertSame($reqBody, file_get_contents('vfs://testReqBody/data'));

您在原始代码中需要注意的另一件事是，使用vfsStreamWrapper::register();

时无需致电vfsStream::setup()

尝试使用VFSStream测试文件系统操作

2 个答案: