file_get_contents
Функция file_get_contents используется для получения содержимого файла в виде одной строки.
Синтаксис:
string file_get_contents ( string filename [, bool use_include_path [, resource context [, int offset [, int maxlen]]]] )
В случае неудачи, функция возвращает false.
Параметры функции:
string filename – путь к файлу, содержимое которого требуется получить. Значением данного параметра может выступать URL. При этом следует помнить, что если в значении параметра используются спецсимволы и русские буквы, то адрес файла следует закодировать с помощью функции urlencode().
bool use_include_path – если значение этого необязательного параметра установить как true, то поиск искомого файла будет также производиться в каталогах, указанных пользователем в диррективе include_path.
resource context – Необязательный пареметр, позволяющий устанавливать контекстные опции и параметры, которые могут быть использованы со всеми файловыми системами и обработчиками потоков. Параметр введён в версии PHP 5.0.0. Контекст создается с помощью функции stream_context_create().
int offset – необязательный параметр, позволяющий считывать строку, начиная с символа с порядковым номером offset. Параметр введён в версии PHP 5.1.0.
int maxlen – необязательный параметр, позволяющий считывать в строке только maxlen символов. Параметр введён в версии PHP 5.1.0.
Для написания парсеров в функции file_get_contents практическое значение имеет только первый обязательный параметр filename.
Пример:
<php
//делаем из страницы сайта свежайший "клон" Яндекса
$str = file_get_contents ('http://yandex.ru');
echo $str;
?>
Дополнительно:
Функции file_get_contents по своему действию похожа на функцию file(). Отличие состоит в том, что file() помещает содержимое удалённого файла не в строку, а в массив. Ключи этого массива – номера строк (начиная с нуля), элементы – содержимое каждой строки. Для написания парсеров функция file() малопригодна.
См. также: