Skip to main content

Opening and Closing a File

PHP, a popular scripting language, gives us the ability to read, write, create and close files on the server. This tutorial will guide you through the process of opening and closing files using PHP.

Opening Files in PHP​

To open a file in PHP, you use the fopen() function. This function requires two arguments:

  • The name of the file you want to open
  • The mode in which you want to open the file

Here's the syntax:

$file = fopen("file.txt", "r");

In the code snippet above, "file.txt" is the name of the file we want to open and "r" is the mode in which we want to open the file. The "r" stands for 'read mode', which means we are opening the file for reading.

The fopen() function returns a file pointer resource on success, or FALSE on error.

If the file does not exist, the function will try to create it (depending on the mode used).

Here are some common modes used in PHP:

  • 'r': read only. Pointer starts at the beginning of the file
  • 'w': write only. Pointer starts at the beginning of the file and truncates the file to zero length. If the file does not exist, it attempts to create it
  • 'a': write only. Pointer starts at the end of the file. If the file does not exist, it attempts to create it
  • 'x': create and write. Returns FALSE if the file already exists
  • 'r+': read/write. Pointer starts at the beginning of the file
  • 'w+': read/write. Pointer starts at the beginning of the file and truncates the file to zero length. If the file does not exist, it attempts to create it
  • 'a+': read/write. Pointer starts at the end of the file. If the file does not exist, it attempts to create it
  • 'x+': create and read/write. Returns FALSE if the file already exists

Closing Files in PHP​

To close a file in PHP, you use the fclose() function. This function requires one argument: the file pointer resource you want to close:

fclose($file);

In the code snippet above, $file is the file pointer resource we want to close. You should always close a file that you have finished working with. This is not only a good programming practice but also a way to free up system resources.

Here's a simple example of opening a file, writing some text, and then closing it:

$file = fopen('file.txt', 'w');

if($file == false ){
   echo "Error in opening new file";
   exit();
}

fwrite($file, 'Hello, world!');

fclose($file);

In this example, we first open 'file.txt' in write mode. If the fopen() function is unable to open the file (perhaps because the file does not exist and cannot be created), it will return FALSE, and we print an error message and exit the script. Otherwise, we write the string 'Hello, world!' to the file and then close it.

That's all there is to opening and closing files in PHP! By mastering these basics, you will be able to perform more complex file operations. Remember, always close your files once you're done with them.