Клиент
класс Client
Client моделирует браузер.
Для выполнения фактического запроса необходимо реализовать метод doRequest().
Если вы хотите иметь возможность запускать запросы в собственном процессе (флаг изоляции), необходимо также реализовать метод getScript().
Методы
| __construct(array $server = array(), История $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 = '') Получает отдельный параметр сервера для заданного ключа. | |
| История | getHistory() Возвращает экземпляр History. | |
| CookieJar | getCookieJar() Возвращает экземпляр CookieJar. | |
| Crawler|null | getCrawler() Возвращает текущий экземпляр Crawler. | |
| Response|null | getInternalResponse() Возвращает текущий экземпляр Response BrowserKit. | |
| object|null | getResponse() Возвращает текущий экземпляр ответа origin. | |
| Request|null | getInternalRequest() Возвращает текущий экземпляр Request BrowserKit. | |
| object|null | getRequest() Возвращает текущий экземпляр запроса origin. | |
| Crawler | click(Ссылка $link) Нажимает на заданную ссылку. | |
| Crawler | submit(Форма $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, Хранилище cookie $cookieJar = null)
Параметры
| array | $server | Параметры сервера (эквивалент $_SERVER) |
| История | $history | Экземпляр History для хранения истории браузера |
| Хранилище cookie | $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 |
Хранилище cookie getCookieJar()
Возвращает экземпляр CookieJar.
Значение, возвращаемое функцией
| Хранилище cookie | Экземпляр CookieJar |
Crawler|null getCrawler()
Возвращает текущий экземпляр Crawler.
Значение, возвращаемое функцией
| Crawler|null | Экземпляр Crawler |
Ответ|null getInternalResponse()
Возвращает текущий экземпляр Response компоненты BrowserKit.
Значение, возвращаемое функцией
| Ответ|null | Экземпляр Response компоненты BrowserKit |
object|null getResponse()
Возвращает текущий экземпляр ответа исходного запроса.
Ответ исходный — экземпляр ответа, который возвращает код, обрабатывающий запросы.
Значение, возвращаемое функцией
| object|null | Экземпляр ответа |
См. также
| doRequest() |
Запрос|null getInternalRequest()
Возвращает текущий экземпляр Request компоненты BrowserKit.
Значение, возвращаемое функцией
| Запрос|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_) |
| 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/4.0/Symfony/Component/BrowserKit/Client.html