Practice_PHPUnit test of STDIN

Amostra de teste PHPUnit para STDIN

Este é um exemplo de teste PHPUnit para verificar a funcionalidade da função abaixo, que recebe um valor de "STDIN" (Standard Input) e retorna esse valor.

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

    return $ contents ;
}

O teste

Para testar a funcionalidade do STDIN usando PHPUnit, uma maneira é criar um mock que substitua um stream php:// como um wrapper e substitua o valor de 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 );
    }
}

O invólucro

O script wrapper para simular o fluxo PHP:// .

• ./testes/MockPhpStream.php

Este invólucro útil foi feito por Denis em sua postagem no blog.

Como testar

Para ver os testes em ação, clone este repositório e execute o teste.

Teste localmente

$ 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)

Teste via 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)