How to Append to a File in PHP: Simple Guide

To append to a file in PHP, use file_put_contents with the FILE_APPEND flag or open the file with fopen in append mode 'a'. Then write your data and close the file to save changes.

Syntax

There are two common ways to append data to a file in PHP:

• file_put_contents: Use the FILE_APPEND flag to add data to the end of the file.
• fopen: Open the file in append mode 'a', write data, then close it.

Both methods add new content without deleting existing data.

php

<?php
// Using file_put_contents to append
file_put_contents('filename.txt', "New line\n", FILE_APPEND);

// Using fopen to append
$file = fopen('filename.txt', 'a');
fwrite($file, "Another line\n");
fclose($file);
?>

Example

This example appends two lines to a file named example.txt. It first uses file_put_contents with FILE_APPEND, then uses fopen in append mode.

php

<?php
// Append using file_put_contents
file_put_contents('example.txt', "Hello, world!\n", FILE_APPEND);

// Append using fopen
$file = fopen('example.txt', 'a');
fwrite($file, "Appended with fopen.\n");
fclose($file);

// Read and output the file content
echo file_get_contents('example.txt');
?>

Output

Hello, world!
Appended with fopen.

Common Pitfalls

Common mistakes when appending to files in PHP include:

• Not using the FILE_APPEND flag with file_put_contents, which overwrites the file instead of appending.
• Opening the file in write mode 'w' instead of append mode 'a', which clears the file.
• Forgetting to close the file after writing with fclose, which can cause data loss.
• Not handling file permissions, which can prevent writing.

php

<?php
// Wrong: overwrites file
file_put_contents('file.txt', "Overwrite\n");

// Right: appends to file
file_put_contents('file.txt', "Append\n", FILE_APPEND);

// Wrong: opens in write mode (clears file)
$file = fopen('file.txt', 'w');
fwrite($file, "Cleared and wrote\n");
fclose($file);

// Right: opens in append mode
$file = fopen('file.txt', 'a');
fwrite($file, "Appended correctly\n");
fclose($file);
?>

Quick Reference

Here is a quick summary of how to append to files in PHP:

Function	Mode/Flag	Description
file_put_contents	FILE_APPEND	Appends data to the file without overwriting
fopen	'a'	Opens file for writing at the end, creates file if not exists
fwrite	N/A	Writes data to an open file handle
fclose	N/A	Closes the open file handle to save changes

Key Takeaways

Use file_put_contents with FILE_APPEND to add data without overwriting.

Open files in append mode ('a') with fopen to write at the end safely.

Always close files with fclose after writing to ensure data is saved.

Avoid opening files in write mode ('w') when you want to append.

Check file permissions to prevent write errors.