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