Practice_PHPUnit test of STDIN

STDIN 的 PHPUnit 測試範例

這是一個範例 PHPUnit 測試，用於檢查以下函數的功能，該函數從「STDIN」（標準輸入）接收一個值並傳回該值。

 function getContentsFromStdin ()
{
    $ contents = file_get_contents ( ' php://stdin ' );
    if ( $ contents === false ){
        throw new  RuntimeException ( ' Failed to read contents from STDIN. ' );
    }

    return $ contents ;
}

測試

要使用 PHPUnit 測試STDIN的功能，一種方法是建立一個模擬來覆蓋php://串流作為包裝器並替換STDIN中的值。

 final class FunctionGetContentsFromStdinTest extends  PHPUnit  Framework TestCase
{
    public function testRegularInput ()
    {
        $ result_expect = ' World! ' ;

        // Register stream wrapper "MockPhpStream" to "php://" protocol
        $ existed = in_array ( ' php ' , stream_get_wrappers ());
        if ( $ existed ) {
            stream_wrapper_unregister ( " php " );
        }
        stream_wrapper_register ( " php " , '\ KEINOSTestsMockPhpStream ' );

        // Set value to STDIN
        file_put_contents ( ' php://stdin ' , $ result_expect );

        // Get value from function and restore registration
        $ result_actual =  KEINOS  Sample getContentsFromStdin ();
        stream_wrapper_restore ( " php " );

        // Test
        $ this -> assertSame ( $ result_expect , $ result_actual );
    }
}

包裝器

用於模擬PHP://串流的包裝器腳本。

• ./tests/MockPhpStream.php

這個有用的包裝是由 Denis 在他的部落格文章中製作的。

如何測試

若要查看正在執行的測試，請複製此儲存庫並執行測試。

本地測試一下

$ composer install
...
$ composer test
> ./vendor/bin/phpunit --testdox --bootstrap ./vendor/autoload.php tests
PHPUnit 7.5.20 by Sebastian Bergmann and contributors.

GetContentsFromFunction
  Regular input

Time: 76 ms, Memory: 4.00 MB

OK (1 test, 1 assertion)

透過 Docker 進行測試

$ docker build -t test:local .
...
$ docker run --rm test:local
> ./vendor/bin/phpunit --testdox --bootstrap ./vendor/autoload.php tests
PHPUnit 9.1.3 by Sebastian Bergmann and contributors.

Get Contents From Function
  Regular input

Time: 00:00.030, Memory: 4.00 MB

OK (1 test, 1 assertion)