array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.fread.php', 1 => 'fread', 2 => 'Читает файл в бинарно-безопасном режиме: как последовательность байтов', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.fputs.php', 1 => 'fputs', ), 'next' => array ( 0 => 'function.fscanf.php', 1 => 'fscanf', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/filesystem/functions/fread.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

fread

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

fread — Читает файл в бинарно-безопасном режиме: как последовательность байтов

Описание

fread(resource $stream, int $length): string|false

Функция fread() считывает заданное параметром length количество байтов из файлового указателя, на который ссылается поток stream. Чтение останавливается, как только выполнилось одно из следующих условий:

Список параметров

stream

Ресурс (resource) указателя файловой системы, который обычно создают функцией fopen().

length

Параметр length указывает размер данных в байтах, которые считает функция.

Возвращаемые значения

Функция возвращает прочитанную строку или false, если возникла ошибка.

Примеры

Пример #1 Простой пример использования функции fread()

<?php

// Получаем содержимое файла в строку
$filename = "/usr/local/something.txt";
$handle = fopen($filename, "r");
$contents = fread($handle, filesize($filename));
fclose($handle);

?>

Пример #2 Пример побайтового чтения функцией fread()

Внимание

В системах, которые различают двоичные и текстовые файлы (например, ОС Windows), файл требуется открывать с включением флага «b» в параметр mode функции fopen().

<?php

$filename = "c:\\files\\somepic.gif";
$handle = fopen($filename, "rb");
$contents = fread($handle, filesize($filename));
fclose($handle);

?>

Пример #3 Примеры удалённого чтения функцией fread()

Внимание

При чтении не из обычного локального файла, а, например, из потоков, которые возвращаются при чтении удалённых файлов или функциями popen() и fsockopen(), чтение остановится после получения функцией доступа к пакету. То есть данные лучше собирать порциями, как показывают примеры в следующих параграфах.

<?php

$handle = fopen("http://www.example.com/", "rb");
$contents = stream_get_contents($handle);
fclose($handle);

?>
<?php

$handle = fopen("http://www.example.com/", "rb");

if (FALSE === $handle) {
exit("Не удалось открыть поток по url адресу");
}

$contents = '';

while (!feof($handle)) {
$contents .= fread($handle, 8192);
}

fclose($handle);

?>

Примечания

Замечание:

Когда требуется просто получить содержимое файла в виде строки, вызывают функцию file_get_contents(), поскольку её производительность выше, чем у кода в приведённых примерах.

Замечание:

Обратите внимание, функция fread() считывает данные с текущей позиции указателя файла. Пользуйтесь функцией ftell(), чтобы найти текущую позицию указателя и функцией rewind(), чтобы перемотать позицию указателя в начало.

Смотрите также