Клиент

класс Клиент

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

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

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

Методы

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

Подробное описание

__construct(array $server = array(), History $history = null, CookieJar $cookieJar = null)

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

Параметры

array	$server	Параметры сервера (эквивалент $_SERVER)
History	$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

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

History getHistory()

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

Значение возврата

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()

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

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

Значение возврата

object|null

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

См. также

doRequest()

Request|null getInternalRequest()

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

Значение возврата

Request|null

Экземпляр Request BrowserKit

object|null getRequest()

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

Origin запрос — это экземпляр объекта Request, который отправляется коду, обрабатывающему запросы.

Значение возврата

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())