Клиент
класс 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() Возвращает текущий экземпляр Request от BrowserKit. | |
| object|null | getRequest() Возвращает текущий экземпляр origin запроса. | |
| 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, ХранилищеCookie $cookieJar = null)
Конструктор.
Параметры
| array | $server | Параметры сервера (эквивалент $_SERVER) |
| История | $history | Экземпляр History для хранения истории браузера |
| ХранилищеCookie | $cookieJar | Экземпляр CookieJar для хранения куки |
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 |
Объект|null getCrawler()
Возвращает текущий экземпляр Crawler.
Значение возврата
| Объект|null | Экземпляр Crawler |
Ответ|null getInternalResponse()
Возвращает текущий экземпляр ответа BrowserKit.
Значение возврата
| Ответ|null | Экземпляр ответа BrowserKit |
объект|null getResponse()
Возвращает текущий экземпляр ответа источника.
Ответ источника — это экземпляр ответа, возвращаемый кодом, обрабатывающим запросы.
Значение возврата
| объект|null | Экземпляр ответа |
См. также
| doRequest() |
Запрос|null getInternalRequest()
Возвращает текущий экземпляр запроса BrowserKit.
Значение возврата
| Запрос|null | Экземпляр запроса BrowserKit |
объект|null getRequest()
Возвращает текущий экземпляр запроса источника.
Запрос источника — это экземпляр запроса, отправляемый коду, обрабатывающему запросы.
Значение возврата
| объект|null | Экземпляр запроса |
См. также
| doRequest() |
Объект click(Ссылка $link)
Нажимает на заданную ссылку.
Параметры
| Ссылка | $link | Экземпляр Ссылка |
Значение возврата
| Объект |
Объект submit(Форма $form, array $values = array())
Отправляет форму.
Параметры
| Форма | $form | Экземпляр Формы |
| array | $values | Массив значений полей формы |
Значение возврата
| Объект |
Объект 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()) |
Значение возврата
| Объект |
Объект back()
Переходит назад в истории браузера.
Значение возврата
| Объект |
Объект forward()
Переходит вперёд в истории браузера.
Значение возврата
| Объект |
Объект reload()
Перезагружает текущий браузер.
Значение возврата
| Объект |
Объект followRedirect()
Следовать ли перенаправлению?
Значение возврата
| Объект |
Исключения
| LogicException | Если запрос не был перенаправлением |
restart()
Перезапускает клиента.
Очищает историю и все куки.
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.2/Symfony/Component/BrowserKit/Client.html