Practice_PHPUnit test of STDIN

Exemple de test PHPUnit pour STDIN

Il s'agit d'un exemple de test PHPUnit pour vérifier le fonctionnement de la fonction ci-dessous, qui reçoit une valeur de "STDIN" (Standard Input) et renvoie cette valeur.

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

    return $ contents ;
}

L'épreuve

Pour tester la fonctionnalité de STDIN à l'aide de PHPUnit, une solution consiste à créer une simulation qui remplace un flux php:// en tant que wrapper et remplace la valeur 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 );
    }
}

L'emballage

Le script wrapper pour se moquer du flux PHP:// .

• ./tests/MockPhpStream.php

Ce wrapper utile a été réalisé par Denis dans son article de blog.

Comment tester

Pour voir les tests en action, clonez ce dépôt et exécutez le test.

Testez-le localement

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

Testez-le 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)