php8.5
Home/ Manual/ filesystem / functions/ feof

feof

PHP function Edit on GitHub ✎

(PHP 4, PHP 5, PHP 7, PHP 8)

Tests for end-of-file on a file pointer

Description

feof(resource $stream): bool

Tests for end-of-file on a file pointer.

Parameters

stream

All

Return Values

Returns true if the file pointer is at EOF or an error occurs (including socket timeout); otherwise returns false.

Notes

Warning

If a connection opened by fsockopen() wasn't closed by the server, feof() will hang. To workaround this, see below example:

Handling timeouts with feof()

php
<?php
function safe_feof($fp, &$start = NULL) {
 $start = microtime(true);

 return feof($fp);
}

/* Assuming $fp is previously opened by fsockopen() */

$start = NULL;
$timeout = ini_get('default_socket_timeout');

while(!safe_feof($fp, $start) && (microtime(true) - $start) < $timeout)
{
 /* Handle */
}
?>
Warning

If the passed file pointer is not valid you may get an infinite loop, because feof() fails to return true.

feof() example with an invalid file pointer

php
<?php
// if file can not be read or doesn't exist fopen function returns FALSE
$file = @fopen("no_such_file", "r");

// FALSE from fopen will issue warning and result in infinite loop here
while (!feof($file)) {
}

fclose($file);
?>

Source: reference/filesystem/functions/feof.xml · from the official PHP manual (php/doc-en)