A função assertContains() é uma função embutida no PHPUnit e é usada para declarar um array com um valor. Esta asserção retornará true no caso se o array contém o valor fornecido senão retorna false e em caso de true o caso de teste declarado foi aprovado senão o caso de teste falhou.

Sintaxe :

assertContains(mixed $value, array $array, string $message = ''])

Parâmetros : esta função aceita três parâmetros, conforme mostrado na sintaxe acima. Os parâmetros são descritos abaixo:

  1. $value : este parâmetro representa o valor a ser contido na matriz.
  2. $array : este parâmetro é um array para o qual a função assert irá verificar se contém valor ou não.
  3. $mensagem : Este parâmetro leva um valor de string. Quando o caso de teste falhou, essa mensagem de string foi exibida como uma mensagem de erro.

Os programas abaixo ilustram a função assertContains():

Programa 1 :

<?php
use PHPUnit\Framework\TestCase;
  
class GeeksPhpunitTestCase extends TestCase
{
    public function testNegativeTestcaseForAssertContains()
    {
        $testArray = array("a"=>"value b", "b" =>"value b");
        $value = "value ba"; 
        // assert function to test whether 'value' is a value of array
        $this->assertContains($value, $testArray, "testArray doesn't contains value as value") ;
    }
}
  
?>

Saída:


Program 2:




<?php
use PHPUnit\Framework\TestCase;
  
class GeeksPhpunitTestCase extends TestCase
{
    public function testPositiveTestcaseForAssertContains()
    {
        $testArray = array("a"=>"value ba", "b" =>"value b");
        $value = "value ba"
        // assert function to test whether 'value' is a value of array
        $this->assertContains($value, $testArray, "testArray doesn't contains value as value") ;
    }
}
  
?>

Output:

PHPUnit 6.5.5 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 21 ms, Memory: 4.00MB

OK (1 test, 1 assertion)

Note : To run testcases with phpunit follow steps from here.