(PHP 4, PHP 5)
feof — 测试文件指针是否到了文件结束的位置
$handle
)
如果文件指针到了 EOF 或者出错时则返回 TRUE
,否则返回一个错误(包括 socket
超时),其它情况则返回 FALSE
。
如果服务器没有关闭由 fsockopen() 所打开的连接, feof()
会一直等待直到超时而返回 TRUE
。默认的超时限制是 60 秒,可以使用
stream_set_timeout() 来改变这个值。
文件指针必须是有效的,必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。
如果传递的文件指针无效可能会陷入无限循环中,因为 EOF 不会返回 TRUE。
Example #1 使用无效文件指针的 feof() 例子
<?php
// 如果文件不可读取或者不存在,fopen 函数返回 FALSE
$file = @fopen("no_such_file", "r");
// 来自 fopen 的 FALSE 会发出一条警告信息并在这里陷入无限循环
while (!feof($file)) {
}
fclose($file);
?>
Returns TRUE
if the file pointer is at EOF or an error occurs
(including socket timeout); otherwise returns FALSE
.
If a connection opened by fsockopen() wasn't closed by the server, feof() will hang. To workaround this, see below example:
Example #2 Handling timeouts with feof()
<?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 */
}
?>
If the passed file pointer is not valid you may get an infinite loop, because
feof() fails to return TRUE
.
Example #3 feof() example with an invalid file pointer
<?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);
?>