PHP: fsync - Manual (original) (raw)

(PHP 8 >= 8.1.0)

fsync — Synchronizes changes to the file (including meta-data)

Description

Parameters

stream

The file pointer must be valid, and must point to a file successfully opened by fopen() orfsockopen() (and not yet closed byfclose()).

Return Values

Returns [true](reserved.constants.php#constant.true) on success or [false](reserved.constants.php#constant.false) on failure.

Examples

Example #1 fsync() example

`<?php

$file

= 'test.txt';$stream = fopen($file, 'w');
fwrite($stream, 'test data');
fwrite($stream, "\r\n");
fwrite($stream, 'additional data');fsync($stream);
fclose($stream);
?>`

See Also

Found A Problem?

Dave Gebler

4 years ago

Two points worth noting:

1. fsync() is not suitable for high throughput, use it only when the durability of a file write really matters to you.

2. fsync() includes an implicit call to fflush() so you don't need to manually flush before you sync.