Friday, October 10, 2025
HomeLanguagesPHPUnit assertFileNotExists() Function

PHPUnit assertFileNotExists() Function

The assertFileNotExists() function is a builtin function in PHPUnit and is used to assert whether a file exists at a given path or not. This assertion will return true in the case if the given file path doesn’t exist else return false. In case of true the asserted test case got passed else test case got failed.

Syntax:

assertFileNotExists(string $filename[, string $message = ''])

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

  • $filename: This parameter is a string that denotes the File path.
  • $message: This parameter takes a string value. When the test case got failed this string message got displayed as an error message.

Below programs illustrate the assertFileNotExists() function in PHPUnit:

Program 1:

PHP




<?php 
use PHPUnit\Framework\TestCase; 
    
class GeeksPhpunitTestCase extends TestCase 
    public function testNegativeTestcaseForAssertFileNotExists() 
    
        $filename = "/home/bittu/Documents/php/"
    
        // Assert function to test whether given 
        // file name exists or not 
        $this->assertFileNotExists( 
            $filename
            "filename exists at given path"
        ); 
    
    
?> 


Output:

PHPUnit 8.5.8 by Sebastian Bergmann and contributors.

F                                             1 / 1 (100%)

Time: 391 ms, Memory: 10.00 MB

There was 1 failure:

1) GeeksPhpunitTestCase::testNegativeTestcaseForAssertFileNotExists
filename exists at given path
Failed asserting that file "/home/bittu/Documents/php/" not exists.

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

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

Program 2:

PHP




<?php 
use PHPUnit\Framework\TestCase; 
    
class GeeksPhpunitTestCase extends TestCase 
    public function testPositiveTestcaseForAssertFileNotExists() 
    
        $filename = "/home/Documents/neveropenDoesNotExist/"
    
        // Assert function to test whether given 
        // file name exists or not 
        $this->assertFileNotExists( 
            $filename
            "filename exists"
        ); 
    
    
?> 


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)
RELATED ARTICLES

Most Popular

Dominic
32349 POSTS0 COMMENTS
Milvus
87 POSTS0 COMMENTS
Nango Kala
6715 POSTS0 COMMENTS
Nicole Veronica
11878 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11941 POSTS0 COMMENTS
Shaida Kate Naidoo
6837 POSTS0 COMMENTS
Ted Musemwa
7097 POSTS0 COMMENTS
Thapelo Manthata
6792 POSTS0 COMMENTS
Umr Jansen
6791 POSTS0 COMMENTS