PHP | Función fflush()

La función fflush() en PHP es una función incorporada que se usa para escribir toda la salida almacenada en búfer en un archivo abierto. La función fflush() fuerza una escritura de todos los resultados almacenados en el búfer en el recurso señalado por el identificador de archivo. La función fflush() devuelve verdadero en caso de éxito y falso en caso de error.

Sintaxis:

fflush($file)

Parámetros: La función fflush() en PHP acepta solo un parámetro que es $archivo. Especifica el flujo de archivo abierto.

Valor devuelto: Devuelve VERDADERO en caso de éxito y FALSO en caso de fallo.

Errores y excepciones :

1. La función fflush() genera errores si el puntero del archivo no es válido.
2. El archivo apuntado debe ser abierto por fopen() o fsockopen() y cerrado por fclose().

Los siguientes programas ilustran la función fflush().

Programa 1 : en el siguiente programa, el archivo llamado singleline.txt contiene una sola línea de información que es «Este archivo consta de una sola línea».

<?php
  
// The file is opened using fopen() function
$check = fopen("singleline.txt", "r");
$seq = fgets($check);
  
// Writing buffered output to a file
// until the end-of-file is reached
while(! feof($check))
    fflush($check);
  
// The file is closed using fclose() function
fclose($check);
  
?>

Producción:

This file consists of a single line.

Programa 2 : En el siguiente programa, el archivo llamado gfg.txt contiene el siguiente fragmento de texto.

Esta es la primera línea.
Esta es la segunda línea.
Esta es la tercera línea.

<?php
  
// The file is opened using fopen() function
$check = fopen("gfg.txt", "r");
$seq = fgets($check);
  
// Writing buffered output to a file
// until the end-of-file is reached
while(! feof($check))
    fflush($check);
  
// The file is closed using fclose() function
fclose($check);
  
?>

Producción:

This is the first line.
This is the second line.
This is the third line.

Referencia:
http://php.net/manual/en/function.fflush.php