file_exists
file_put_contents
Файловая система
PHP Manual

# 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 в List of Supported Protocols/Wrappers.

Внимание

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

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

- file() - Читает содержимое файла и помещает его в массив
- fgets() - Читает строку из файла
- fread() - Бинарно-безопасное чтение файла
- readfile() - Выводит файл
- file_put_contents() - Записать строку в файл

file_exists
file_put_contents
Файловая система
PHP Manual