fsync

(PHP 8 >= 8.1.0)

fsync — 同步文件变更(包括元数据)

说明

function fsync(resource $stream): bool

此函数同步文件变更,包括元数据。与 fflush() 类似,但同时还让操作系统将变更写入到存储介质。

参数

stream: 文件指针必须是有效的,必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。

返回值

成功时返回 true , 或者在失败时返回 false 。

示例

示例 #1 fsync() 示例

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

参见

fdatasync() - 同步文件数据(不包含元数据)
fflush() - 将缓冲内容输出到文件

发现了问题?

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

+添加备注

用户贡献的备注 1 note

down

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.