file

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

file - Читає вміст файлу і поміщає його в масив

Опис

file(string $filename, int $flags = 0, ?resource $context = null): array|false

Читає вміст файлу та поміщає його у масив.

Зауваження :

Можна також використовувати функцію file_get_contents() для отримання файлу у вигляді рядка.

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

filename

Шлях до файлу.

Підказка

У цю функцію як ім'я файлу можна передавати URL-адреси, якщо була включена директива fopen wrappers. Докладніше про те, як вказати ім'я файлу, описано в описі функції fopen(). В розділі "Підтримувані протоколи та обгортки» також дано посилання на інформацію про можливості підтримуваних обгорток, зауваження щодо роботи з ними та список визначених змінних, які вони дають.

flags

Як необов'язковий параметр flags може вказати одну або більше наступних констант:

FILE_USE_INCLUDE_PATH

Шукає файл у include_path

FILE_IGNORE_NEW_LINES

Пропускати новий рядок наприкінці кожного елемента масиву

FILE_SKIP_EMPTY_LINES

Пропускати порожні рядки

FILE_NO_DEFAULT_CONTEXT

Не використовувати контекст за замовчуванням

context

Ресурс (resource) сконтекстом потоку

Значення, що повертаються

Повертає файл як масиву. Кожен елемент масиву відповідає рядку файлу з символами нового рядка включно. У разі помилки file() повертає false

Зауваження :

Кожен рядок в отриманому масиві завершуватиметься символами кінця рядка, якщо тільки не використовується FILE_IGNORE_NEW_LINES

Зауваження: Якщо виникають проблеми з розпізнаванням PHP кінців рядків під час читання або створення файлів на Macintosh-сумісному комп'ютері, увімкнення опції auto_detect_line_endingsможет помочь решить проблему.

Помилки

Викликає помилку рівня **E_WARNING**якщо файл не існує.

Приклади

Приклад #1 Приклад використання file()****

Loading...
▶

Примітки

Увага

При використанні SSL Microsoft IIS порушує протокол, закриваючи з'єднання без надсилання індикатора close_notify. PHP повідомить про це як "SSL: Fatal Protocol Error" в той момент, коли буде досягнуто кінця даних. Щоб обійти це, потрібно встановити директиву error_reportingна уровень, исключающий E_WARNING. PHP вміє визначати, що на стороні сервера проблемний IIS при відкритті потоку обгорткою https:// та не виводить попередження. Якщо розробник створює сокет ssl:// через виклик функції fsockopen(), він сам відповідає за визначення та придушення цього попередження.

Дивіться також

• file_get_contents() - Читає вміст файлу в рядок
• readfile() - Виводить файл
• fopen() - Відкриває файл або URL
• fsockopen() - Відкриває з'єднання з інтернет-сокетом або доменним сокетом Unix
• popen() - Відкриває файловий покажчик процесу
• include - include
• stream_context_create() - Створює контекст потоку