Как считать первую строку файла в PHP: методы и нюансы

Чтение первой строки из очень большого файла (гигабайты)

Используйте fgets() с указанием буфера, чтобы гарантировать чтение полностью:

$handle = fopen('huge.log', 'r');
if ($handle) {
    // Буфер 8 КБ - покроет почти любую строку
    $first = fgets($handle, 8192);
    if ($first === false) {
        echo 'Файл пуст или ошибка чтения';
    } else {
        echo 'Первая строка: ', $first;
    }
    fclose($handle);
} else {
    echo 'Не удалось открыть файл';
}
  

Результат (для файла с одной строкой):

Первая строка: [содержимое первой строки]

Обработка файла в кодировке UTF-8 с BOM

Если первая строка начинается с BOM (Byte Order Mark), fgets() вернёт её вместе с BOM. Пример удаления BOM:

function removeBom($text) {
    $bom = pack('H*','EFBBBF');
    return preg_replace('/^'.$bom.'/', '', $text);
}

$handle = fopen('utf8_bom.txt', 'r');
$first = fgets($handle);
$firstClean = removeBom($first);
fclose($handle);
  

Результат:

Первая строка без BOM

Использование stream_filter для чтения с конвертацией кодировки

Если файл в Windows-1251, а скрипт ожидает UTF-8, можно применить фильтр:

$handle = fopen('win1251.txt', 'r');
stream_filter_append($handle, 'convert.iconv.windows-1251/utf-8');
$firstLine = fgets($handle);
fclose($handle);
echo $firstLine;
  

Чтение первой строки из CSV (первая строка - заголовок)

Для CSV удобно использовать fgetcsv(), которая автоматически парсит поля:

$handle = fopen('data.csv', 'r');
$header = fgetcsv($handle); // возвращает массив полей первой строки
if ($header) {
    echo 'Заголовки: ', implode(', ', $header);
}
fclose($handle);
  

Результат:

Заголовки: ID, Name, Email

Получение первой строки без использования fopen (для URL)

С помощью file_get_contents() с флагами можно получить только первую строку, но это всё равно загрузит всё содержимое:

$content = file_get_contents('https://example.com/file.txt');
$firstLine = substr($content, 0, strpos($content, "\n"));
echo $firstLine;
  

Недостаток: память под весь файл. Для небольших удалённых файлов допустимо.

Проверка первой строки без считывания всего файла (для проверки формата)

Используйте fgets() для быстрой проверки:

$handle = @fopen('config.ini', 'r');
if ($handle) {
    $firstLine = fgets($handle);
    fclose($handle);
    if (strpos($firstLine, '<?') !== false) {
        echo 'Возможно, это PHP-скрипт';
    }
} else {
    echo 'Файл не найден';
}
  

Результат:

Возможно, это PHP-скрипт