(PHP 4, PHP 5, PHP 7, PHP 8)
fread — Бинарно-безопасное чтение файла
$stream, int $length): string|false
fread() читает до
length байт из файлового указателя
stream и смещает указатель. Чтение останавливается как только
было достигнуто одно из следующих условий:
length байт
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() для перемотки позиции указателя в начало.