(PHP 4, PHP 5, PHP 7)
fgets — Читает строку из файла
$handle
[, int $length
] ) : stringЧитает строку из файлового указателя.
handle
Указатель на файл должен быть корректным и указывать на файл, успешно открытый функциями fopen() или fsockopen() (и все еще не закрытый функцией fclose()).
length
Чтение заканчивается при достижении length
- 1 байт,
либо если встретилась новая строка (которая включается в возвращаемый результат)
или конец файла (в зависимости от того, что наступит раньше).
Если длина не указана, чтение из потока будет продолжаться до тех пор,
пока не достигнет конца строки.
Возвращает строку размером в length
- 1 байт, прочитанную
из дескриптора файла, на который указывает параметр handle
.
Если данных для чтения больше нет, то возвращает FALSE
.
В случае возникновения ошибки возвращает FALSE
.
Пример #1 Построчное чтение файла
<?php
$handle = @fopen("/tmp/inputfile.txt", "r");
if ($handle) {
while (($buffer = fgets($handle, 4096)) !== false) {
echo $buffer;
}
if (!feof($handle)) {
echo "Ошибка: fgets() неожиданно потерпел неудачу\n";
}
fclose($handle);
}
?>
Замечание: Если у вас возникают проблемы с распознаванием PHP концов строк при чтении или создании файлов на Macintosh-совместимом компьютере, включение опции auto_detect_line_endings может помочь решить проблему.
Замечание:
Программисты, привыкшие к семантике 'C' функции fgets(), должны принимать во внимание разницу в том, каким образом возвращается признак достижения конца файла (EOF).