fflush()

Introducción a la función fflush() de PHP

La función fflush() de PHP se utiliza para vaciar el búfer de salida de un puntero de archivo. Fuerza que cualquier dato en búfer se escriba inmediatamente en el flujo subyacente. Esto es particularmente útil para registros (logging), procesamiento de datos en tiempo real o para garantizar la persistencia de los datos antes de que finalice un script.

La función fflush() acepta un parámetro: el puntero de archivo que desea vaciar. En este artículo, discutiremos la sintaxis y los parámetros de la función fflush(), junto con ejemplos prácticos de cómo utilizarla.

Sintaxis

La sintaxis de la función fflush() es la siguiente:

La sintaxis de fflush() en PHP

bool fflush ( resource $stream )

• stream: el puntero de archivo que se debe vaciar

Parámetros

La función fflush() toma un parámetro obligatorio:

1. $stream: El puntero de archivo que desea vaciar. Este parámetro debe ser un recurso creado mediante la función fopen() o una función similar para crear flujos.

Valor devuelto

Devuelve true en caso de éxito o false en caso de error. Si el flujo no está abierto, no es escribible o la operación falla, la función devuelve false y puede emitir una advertencia.

Ejemplos

A continuación se muestran algunos ejemplos de cómo utilizar la función fflush():

Ejemplo 1: Vaciar un puntero de archivo

El siguiente ejemplo abre un archivo, escribe datos y vacía inmediatamente el búfer para garantizar que los datos se escriban en el disco:

Vaciar un puntero de archivo en PHP

<‌?php

$fileHandle = fopen('example.txt', 'w');
fwrite($fileHandle, 'Hello, World!');
fflush($fileHandle);
fclose($fileHandle);

Ejemplo 2: Vaciar múltiples punteros de archivo

El siguiente ejemplo muestra cómo vaciar múltiples descriptores de archivo abiertos:

Vaciar múltiples punteros de archivo en PHP

<‌?php

$fileHandle1 = fopen('log1.txt', 'a');
$fileHandle2 = fopen('log2.txt', 'a');

fwrite($fileHandle1, 'Data for log 1');
fwrite($fileHandle2, 'Data for log 2');

fflush($fileHandle1);
fflush($fileHandle2);

fclose($fileHandle1);
fclose($fileHandle2);

Nota sobre el búfer de salida

No confunda fflush() con las funciones de búfer de salida de PHP como ob_flush(). fflush() opera en flujos de archivos (por ejemplo, archivos, sockets, tuberías), mientras que ob_flush() vacía el búfer de salida interno de PHP hacia el servidor web o el cliente.

Conclusión

En conclusión, la función fflush() es una función útil de PHP que garantiza que los datos en búfer se escriban inmediatamente en un flujo de archivo. Es esencial para aplicaciones que requieren persistencia de datos en tiempo real, como sistemas de registro o scripts de procesamiento de datos.

Al utilizar los ejemplos proporcionados en este artículo, ahora debería poder usar la función fflush() en su código PHP con facilidad. Si tiene alguna pregunta o duda sobre el uso de la función fflush() en PHP, no dude en contactarnos. Estaremos encantados de ayudarle.

Práctica

¿Cuál es el uso correcto de la función fflush() en PHP?

Restablece el indicador de posición del archivo en el flujo actual.Se utiliza para vaciar el búfer de salida del archivo abierto.Tras la función fflush(), debe usarse la función fclose() para asegurar que PHP comprenda que el archivo debe cerrarse.La función fflush() no puede utilizarse para ningún flujo que no esté basado en archivos.El uso de la función fflush() afecta tanto al búfer de salida a nivel del sistema como al búfer interno de PHP.