Friday, September 5, 2025
HomeLanguagesPHPUnit assertNull() Function

PHPUnit assertNull() Function

The assertNull() function is a builtin function in PHPUnit and is used to assert whether the variable is Null or not. This assertion will return true in the case if the variable is Null else return false. In case of true the asserted test case got passed else test case got failed.

Syntax:

assertNull(mixed $variable[, string $message = ''])

Parameters: This function accepts two parameters as mentioned above and described below:

  • $Variable: This parameter represents any type of variable.
  • $message: This parameter takes a string value. When the test case got failed this string message got displayed as an error message.

Below examples illustrate the  assertNull() function in PHPUnit:

Example 1:

PHP




<?php 
use PHPUnit\Framework\TestCase; 
    
class GeeksPhpunitTestCase extends TestCase 
    public function testNegativeTestcaseForassertNull() 
    
        $variable = "Null"
    
        // Assert function to test whether given 
        // variable is Null or not 
        $this->assertNull( 
            $variable
            "variable is null or not"
        ); 
    
    
?> 


Output:

PHPUnit 8.5.8 by Sebastian Bergmann and contributors.

F                                                  1 / 1 (100%)

Time: 88 ms, Memory: 10.00 MB

There was 1 failure:

1) GeeksPhpunitTestCase::testPositiveTestcaseForassertNull
variable is null or not
Failed asserting that 'Null' is null.

/home/lovely/Documents/php/test.php:15

FAILURES!
Tests: 1, Assertions: 1, Failures: 1.

Example 2:

PHP




<?php 
use PHPUnit\Framework\TestCase; 
    
class GeeksPhpunitTestCase extends TestCase 
    public function testPositiveTestcaseForassertNull() 
    
        $variable = Null; 
    
        // Assert function to test whether given 
        // variable is Null or not 
        $this->assertNull( 
            $variable
            "variable is null or not"
        ); 
    
    
?> 


Output:

PHPUnit 8.5.8 by Sebastian Bergmann and contributors.

.                                                 1 / 1 (100%)

Time: 88 ms, Memory: 10.00 MB

OK (1 test, 1 assertion)

Reference:https://phpunit.readthedocs.io/en/9.2/assertions.html#assertnull

Dominic
Dominichttp://wardslaus.com
infosec,malicious & dos attacks generator, boot rom exploit philanthropist , wild hacker , game developer,
RELATED ARTICLES

Most Popular

Dominic
32267 POSTS0 COMMENTS
Milvus
81 POSTS0 COMMENTS
Nango Kala
6635 POSTS0 COMMENTS
Nicole Veronica
11801 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11865 POSTS0 COMMENTS
Shaida Kate Naidoo
6752 POSTS0 COMMENTS
Ted Musemwa
7026 POSTS0 COMMENTS
Thapelo Manthata
6703 POSTS0 COMMENTS
Umr Jansen
6720 POSTS0 COMMENTS