Клиент
класс Клиент
Клиент имитирует браузер.
Чтобы сделать фактический запрос, необходимо реализовать метод doRequest().
Если вы хотите иметь возможность запускать запросы в собственном процессе (флаг изоляции), вам также необходимо реализовать метод getScript().
Методы
| __construct(array $server = array(), История $history = null, ХранилищеCookies $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 = '') Получает один параметр сервера для указанного ключа. | |
| История | getHistory() Возвращает экземпляр History. | |
| ХранилищеCookies | getCookieJar() Возвращает экземпляр CookieJar. | |
| Робот|null | getCrawler() Возвращает текущий экземпляр робота. | |
| Ответ|null | getInternalResponse() Возвращает текущий экземпляр ответа BrowserKit. | |
| object|null | getResponse() Возвращает текущий экземпляр ответа источника. | |
| Запрос|null | getInternalRequest() Возвращает текущий экземпляр запроса BrowserKit. | |
| object|null | getRequest() Возвращает текущий экземпляр запроса источника. | |
| Робот | click(Ссылка $link) Нажимает на заданную ссылку. | |
| Робот | submit(Форма $form, array $values = array()) Отправляет форму. | |
| Робот | request(string $method, string $uri, array $parameters = array(), array $files = array(), array $server = array(), string $content = null, bool $changeHistory = true) Вызывает URI. | |
| Робот | back() Возвращается в истории браузера. | |
| Робот | forward() Переходит вперёд в истории браузера. | |
| Робот | reload() Перезагружает текущий браузер. | |
| Робот | 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 |
Значение возврата
| Crawler |
Crawler submit(Форма $form, array $values = array())
Отправляет форму.
Параметры
| Форма | $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()) |
Значение возврата
| Crawler |
Crawler back()
Переходит назад в истории браузера.
Значение возврата
| Crawler |
Crawler forward()
Переходит вперед в истории браузера.
Значение возврата
| Crawler |
Crawler reload()
Перезагружает текущий браузер.
Значение возврата
| Crawler |
Crawler followRedirect()
Следовать перенаправлению?
Значение возврата
| Crawler |
Исключения
| LogicException | Если запрос не был перенаправлением |
restart()
Перезапускает клиента.
Очищает историю и все файлы cookie.
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.4/Symfony/Component/BrowserKit/Client.html