fread
(PHP 4, PHP 5, PHP 7, PHP 8)
fread — Бінарно-безпечне читання файлу
Опис
fread(resource $stream, int $length): string|false
fread() читає до length байт із файлового покажчика stream та зміщує покажчик. Читання зупиняється як тільки було досягнуто однієї з наступних умов:
- було прочитано
lengthбайт - досягнуто EOF (кінець файлу)
- став доступний пакет або минувчас очікування сокету(для мережевих потоків)
- якщо потік, що читається, є буферизованим і не являє собою звичайний файл, то за один раз максимум читається кількість байт, рівну розміру однієї порції даних (зазвичай це 8192), однак, залежно від раніше буферизованих даних розмір даних, що повертаються, може бути більше розміру однієї порції даних .
Список параметрів
stream
Вказівник (resource) на файл, який зазвичай створюється за допомогою функції fopen()
length
length вказує розмір прочитаних даних у байтах.
Значення, що повертаються
Повертає прочитаний рядок або **false**в случае возникновения ошибки.
Приклади
Приклад #1 Простий приклад використання fread()
Приклад #2 Приклад бінарного читання за допомогою fread()
Увага
На системах, які розрізняють бінарні та текстові файли (наприклад, Windows), файл має бути відкритий з використанням прапора 'b' у параметрі mode функції fopen()
Приклад #3 Приклади віддаленого читання за допомогою fread()
Увага
При читанні чогось відмінного від локальних файлів, наприклад потоків, що повертаються під час читання віддалених файлівили изpopen() і fsockopen(), читання зупиниться після того, як пакет стане доступним. Це означає, що ви повинні збирати дані разом на шматочки, як показано на прикладі нижче.
Примітки
Зауваження :
Якщо ви просто хочете отримати вміст файлу у вигляді рядка, використовуйте file_get_contents(), оскільки ця функція набагато продуктивніша, ніж описаний вище код.
Зауваження :
Врахуйте, що fread() читає, починаючи з поточної позиції файлового покажчика. Використовуйте функцію ftell() для знаходження поточної позиції покажчика та функцію rewind() для перемотування позиції покажчика на початок.
Дивіться також
- fwrite() - Бінарно-безпечний запис у файл
- fopen() - Відкриває файл або URL
- fsockopen() - Відкриває з'єднання з інтернет-сокетом або доменним сокетом Unix
- popen() - Відкриває файловий покажчик процесу
- fgets() - Читає рядок із файлу
- fgetss() - Читає рядок з файлу та видаляє HTML-теги
- fscanf() - Обробляє дані з файлу відповідно до формату
- file() - Читає вміст файлу та поміщає його в масив
- fpassthru() - Виводить всі дані з файлового покажчика, що залишилися.
- fseek() - Встановлює зміщення у файловому покажчику
- ftell() - Повертає поточну позицію покажчика читання/запису файлу
- rewind() - Скидає курсор файлового покажчика
- unpack() - Розпакувати дані з бінарного рядка