PHP | ftruncate( )函数

介绍

ftruncate()函数用于截断文件到指定长度。如果文件长于指定长度，则超过的部分将被删除；如果文件短于指定长度，则文件将扩展并且补充 null 字节。

该函数通常用于日志文件或其他需要存档或轮转的文件。使用此功能时，请确保文件是打开并且您具有适当的权限。

语法

bool ftruncate ( resource $handle , int $size )

参数

• handle: 打开文件的文件指针。
• size: 指定截断后的文件大小。

返回值

如果成功，函数将返回 true，否则将返回 false。

示例

$filename = 'test.txt';
$handle = fopen($filename, 'r+');

// 将 test.txt 截断为 10 个字节
if (ftruncate($handle, 10)) {
  echo '文件截断成功';
} else {
  echo '文件截断失败';
}

fclose($handle);

上面的代码将打开名为 test.txt 的文件，将其截断为 10 个字节，如果成功，则在浏览器中输出 文件截断成功。

注意事项

• 文件必须以可写方式打开，否则将出现错误。
• 如果文件已经打开，那么它应该在尝试执行此函数之前被关闭。要关闭文件，需要使用 fclose()函数。
• 如果截断文件失败，则必须检查是否有适当的权限以进行此操作。
• 在某些操作系统上，文件大小可能被限制为 2 GB（2 ^ 31字节）之内。如果超过此限制，则不得使用此函数进行截断。