Руководство по PHP
Пред. |  | След.

# file_get_contents

(PHP 4 >= 4.3.0, PHP 5)

file_get_contents -- Получить содержимое файла в виде одной строки

## Описание

string file_get_contents ( string filename [, bool use_include_path [, resource context [, int offset [, int maxlen]]]] )

Данная функция идентична функции file() с той только разницей, что содержимое файла возвращается в строке, начиная с указанного смещения offset и до maxlen байтов. В случае неудачи, file_get_contents() вернёт `FALSE`.

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

> Замечание: Если вы открываете URI содержащий спецсимволы, такие как пробел, вам нужно закодировать URI при помощи urlencode().

## Список изменений

Версия | Описание
--- | ---
5.0.0 | Добавлена поддержка контекста.
5.1.0 | Добавлены аргументы offset и maxlen.

## Примечания

> Замечание: Эта функция безопасна для обработки данных в двоичной форме.

> Подсказка: Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция "fopen wrappers". Смотрите более подробную информацию об определении имени файла в описании функции fopen(), а также список поддерживаемых протоколов URL в Прил. L.

Внимание
При использовании SSL, Microsoft IIS будет нарушать протокол, закрывая соединение без отправки индикатора close_notify. PHP сообщит об этом как о "SSL: Fatal Protocol Error" в момент, когда вы достигните конца данных. Чтобы обойти это, вы должны опустить ваш уровень error_reporting, чтобы исключить предупреждения (E_WARNING). PHP 4.3.7 и младше может определять глючный IIS-сервер, когда вы открываете поток используя обвёртку https://, и не отобразит это предупреждение. Если вы используете fsockopen() для создания ssl:// сокета, вы сами отвечаете за определение и подавление этого предупреждения.

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

file()
fgets()
fread()
readfile()
file_put_contents()

Пред. | Начало | След.
file_exists | Уровень выше | file_put_contents