Клиент

класс Client

Client моделирует браузер.

Чтобы выполнить фактический запрос, необходимо реализовать метод doRequest().

Если вы хотите иметь возможность запускать запросы в собственном процессе (флаг изоляции), необходимо также реализовать метод getScript().

Методы

	__construct(array $server = array(), History $history = null, CookieJar $cookieJar = null) Конструктор.
	followRedirects(bool $followRedirect = true) Устанавливает, следует ли автоматически перенаправлять или нет.
bool	isFollowingRedirects() Возвращает, следует ли клиент автоматически перенаправлениям или нет.
	setMaxRedirects(int $maxRedirects) Устанавливает максимальное количество запросов, которые может отслеживать робот.
int	getMaxRedirects() Возвращает максимальное количество запросов, которые может отслеживать робот.
	insulate(bool $insulated = true) Устанавливает флаг изоляции.
	setServerParameters(array $server) Устанавливает параметры сервера.
	setServerParameter(string $key, string $value) Устанавливает отдельный параметр сервера.
string	getServerParameter(string $key, string $default = '') Получает отдельный параметр сервера для указанного ключа.
History	getHistory() Возвращает экземпляр History.
CookieJar	getCookieJar() Возвращает экземпляр CookieJar.
Crawler\|null	getCrawler() Возвращает текущий экземпляр Crawler.
Response\|null	getInternalResponse() Возвращает текущий экземпляр Response BrowserKit.
object\|null	getResponse() Возвращает текущий экземпляр ответа исходного источника.
Request\|null	getInternalRequest() Возвращает текущий экземпляр запроса BrowserKit.
object\|null	getRequest() Возвращает текущий экземпляр запроса исходного источника.
Crawler	click(Link $link) Нажимает на заданную ссылку.
Crawler	submit(Form $form, array $values = array()) Отправляет форму.
Crawler	request(string $method, string $uri, array $parameters = array(), array $files = array(), array $server = array(), string $content = null, bool $changeHistory = true) Обращается к URI.
Crawler	back() Возвращается назад в истории браузера.
Crawler	forward() Переходит вперед в истории браузера.
Crawler	reload() Перезагружает текущий браузер.
Crawler	followRedirect() Следовать перенаправлениям?
	restart() Перезапускает клиент.

Подробности

__construct(array $server = array(), История $history = null, CookieJar $cookieJar = null)

Конструктор.

Параметры

array	$server	Параметры сервера (эквивалент $_SERVER)
История	$history	Экземпляр History для хранения истории браузера
CookieJar	$cookieJar	Экземпляр CookieJar для хранения файлов cookie

followRedirects(bool $followRedirect = true)

Устанавливает, следует ли автоматически перенаправлениям или нет.

Параметры

bool

$followRedirect

Следовать ли перенаправлениям

bool isFollowingRedirects()

Возвращает, следует ли клиент автоматически перенаправлениям или нет.

Значение, возвращаемое функцией

bool

setMaxRedirects(int $maxRedirects)

Устанавливает максимальное количество запросов, которые может отследить робот.

Параметры

int

$maxRedirects

int getMaxRedirects()

Возвращает максимальное количество запросов, которые может отследить робот.

Значение, возвращаемое функцией

int

insulate(bool $insulated = true)

Устанавливает флаг изоляции.

Параметры

bool

$insulated

Производить изоляцию запросов или нет

Исключения

RuntimeException

При отсутствии компоненты Symfony Process

setServerParameters(array $server)

Устанавливает параметры сервера.

Параметры

array

$server

Массив параметров сервера

setServerParameter(string $key, string $value)

Устанавливает отдельный параметр сервера.

Параметры

string	$key	Ключ параметра
string	$value	Значение параметра

string getServerParameter(string $key, string $default = '')

Получает отдельный параметр сервера по указанному ключу.

Параметры

string	$key	Ключ параметра для получения
string	$default	Значение по умолчанию при отсутствии ключа

Значение, возвращаемое функцией

string

Значение параметра

История getHistory()

Возвращает экземпляр History.

Значение, возвращаемое функцией

История

Экземпляр History

CookieJar getCookieJar()

Возвращает экземпляр CookieJar.

Значение, возвращаемое функцией

CookieJar

Экземпляр CookieJar

Crawler|null getCrawler()

Возвращает текущий экземпляр Crawler.

Значение, возвращаемое функцией

Crawler|null

Экземпляр Crawler

Response|null getInternalResponse()

Возвращает текущий экземпляр Response BrowserKit.

Значение, возвращаемое функцией

Response|null

Экземпляр Response BrowserKit

object|null getResponse()

Возвращает текущий экземпляр ответа источника.

Ответ источника — это экземпляр ответа, который возвращается кодом, обрабатывающим запросы.

Значение, возвращаемое функцией

object|null

Экземпляр ответа

См. также

doRequest()

Request|null getInternalRequest()

Возвращает текущий экземпляр Request BrowserKit.

Значение, возвращаемое функцией

Request|null

Экземпляр Request BrowserKit

object|null getRequest()

Возвращает текущий экземпляр запроса источника.

Запрос источника — это экземпляр запроса, отправленный коду, обрабатывающему запросы.

Значение, возвращаемое функцией

object|null

Экземпляр запроса

См. также

doRequest()

Crawler click(Link $link)

Нажимает на заданную ссылку.

Параметры

Link

$link

Экземпляр Link

Значение, возвращаемое функцией

Crawler

Crawler submit(Form $form, array $values = array())

Отправляет форму.

Параметры

Form	$form	Экземпляр Form
array	$values	Массив значений полей формы

Значение, возвращаемое функцией

Crawler

Crawler request(string $method, string $uri, array $parameters = array(), array $files = array(), array $server = array(), string $content = null, bool $changeHistory = true)

Вызывает URI.

Параметры

string	$method	Метод запроса
string	$uri	URI для получения
array	$parameters	Параметры запроса
array	$files	Файлы
array	$server	Параметры сервера (заголовки HTTP ссылаются с префиксом HTTP_ как в PHP)
string	$content	Сырые данные тела
bool	$changeHistory	Обновить историю или нет (используется только внутри для back(), forward() и reload())