file_exists()

Last updated on

Whether you are just trying to keep your app from crashing or making sure your users’ uploads don’t accidentally overwrite each other’s files, php file_exists is like a simple yet reliable tool in your PHP toolkit.

In this tutorial, you will learn what file_exists is and how it works. Let's get started.

What is php file_exists?

php file_exists is a built-in function. It takes a file path as input and checks if that file or directory is sitting there on your server, waiting to be used. If it’s there, file_exists returns true. If it’s not, you get false. This might seem small, but it can prevent a ton of problems.

Whenever you’re handling user uploads, dynamic file includes, or any process where files might pop in and out file_exists can be fit for this task.

Here is its syntax:

file_exists($path);

Just put in the file path you want to check. If the file or directory is there, file_exists will give you true. If not, it’ll return false. Here’s a quick example:

if (file_exists("example.txt")) {
    echo "The file exists!";
} else {
    echo "File not found.";
}

The file_exists doesn’t actually open the file. It just checks the file system to see if the file or directory is there where you specified. But here’s something to keep in mind: file_exists is case-sensitive on Linux but case-insensitive on Windows. So if you’re working across different operating systems, double-check those file paths to prevent any issues.

Another thing else, file_exists works for both files and directories. But, if you want to make sure you’re dealing with a file (not a directory), use file_exists with is_file or is_dir to be extra sure.

In the following section, you will see more examples. Let's move on.

Examples of PHP file_exists

In the example, we are going to prevent duplicate uploads:

$uploadDir = "uploads/";
$filename = $_FILES["userfile"]["name"];
$filepath = $uploadDir . $filename;

if (file_exists($filepath)) {
    $newFileName = time() . "_" . $filename;
    $newFilePath = $uploadDir . $newFileName;
    move_uploaded_file($_FILES["userfile"]["tmp_name"], $newFilePath);
    echo "File already exists, so it was saved as $newFileName.";
} else {
    move_uploaded_file($_FILES["userfile"]["tmp_name"], $filepath);
    echo "File uploaded successfully!";
}

file_exists checks if the file name is already taken. If it is, the code adds a timestamp to create a unique name and saves it as a new file. So, no overwrites.

Here, we should check first if the file exists before including it in another PHP file:

$filename = "config.php";

if (file_exists($filename)) {
    include $filename;
} else {
    echo "Required configuration file is missing!";
}

With this code, you are safe from those annoying “file not found” errors. You’ll know right away if config.php is missing.

Let's summarize it.

Wrapping Up

PHP file_exists is a simple way to check if a file or directory exists. Here’s a quick recap:

  • Definition: php file_exists checks if a file or directory is present on the server.
  • Syntax: Just use file_exists($path);, where $path is the file or directory you want to check.
  • How It Works: It verifies existence without actually opening the file.

Thank you for reading to the end. Happy coding!

Frequently Asked Questions (FAQs)

  • What is PHP file_exists?

    PHP file_exists is a built-in function that checks if a file or directory exists on the server. It returns true if the file is there and false if it’s not, helping avoid issues like accidental file overwrites or missing files.

  • How does file_exists work in PHP?

    The file_exists function takes a file path as an argument and checks if that path exists. It doesn’t open or interact with the file itself, just verifies if it’s there. Example: 
    if (file_exists("example.txt")) {
    echo "The file exists!";
} else {
    echo "File not found.";
}

  • What is the syntax for file_exists in PHP?

    The syntax is simple: file_exists($path); where $path is the file or directory path you want to check.

  • Does file_exists work for directories?

    Yes, file_exists works for both files and directories. However, if you specifically want to check for files, pair it with is_file. To check for directories, pair it with is_dir. 
    if (file_exists("uploads") && is_dir("uploads")) {
    echo "Directory exists!";
} else {
    echo "Directory not found.";
}

  • Is file_exists case-sensitive in PHP?

    file_exists is case-sensitive on Linux but case-insensitive on Windows. So, be cautious with file paths if you’re working across different operating systems.

  • Can file_exists prevent duplicate file uploads?

    Yes, file_exists can help avoid duplicate uploads by checking if a file already exists before saving. Here’s an example: 
    $uploadDir = "uploads/";
$filename = $_FILES["userfile"]["name"];
$filepath = $uploadDir . $filename;

if (file_exists($filepath)) {
    $newFileName = time() . "_" . $filename;
    $newFilePath = $uploadDir . $newFileName;
    move_uploaded_file($_FILES["userfile"]["tmp_name"], $newFilePath);
    echo "File already exists, so it was saved as $newFileName.";
} else {
    move_uploaded_file($_FILES["userfile"]["tmp_name"], $filepath);
    echo "File uploaded successfully!";
}
    In this code, file_exists checks if the file name is already in use. If it is, the file is renamed with a timestamp to prevent overwriting.

  • How can I use file_exists to prevent missing file errors in PHP?

    Use file_exists before including files to avoid “file not found” errors. Example: 
    $filename = "config.php";

if (file_exists($filename)) {
    include $filename;
} else {
    echo "Required configuration file is missing!";
}
    This approach ensures that config.php exists before the script tries to include it, helping avoid runtime errors.

  • When should I use PHP file_exists?

    Use file_exists whenever you need to verify a file or directory’s presence before reading, writing, or including it. It’s especially useful for handling uploads, conditional file includes, or checking dependencies in your app.
Share on: