Клиент
класс Client расширяет Client
Клиент моделирует браузер и отправляет запросы к объекту ядра.
Методы
| __construct(HttpKernelInterface $kernel, array $server = array(), History $history = null, CookieJar $cookieJar = null) Конструктор. | ||
| followRedirects(bool $followRedirect = true) Устанавливает, следует ли автоматически перенаправлять или нет. | из Client | |
| setMaxRedirects(int $maxRedirects) Устанавливает максимальное количество запросов, которые может отслеживать робот. | из Client | |
| insulate(bool $insulated = true) Устанавливает флаг изоляции. | из Client | |
| setServerParameters(array $server) Устанавливает параметры сервера. | из Client | |
| setServerParameter(string $key, string $value) Устанавливает отдельный параметр сервера. | из Client | |
| string | getServerParameter(string $key, string $default = '') Получает отдельный параметр сервера для указанного ключа. | из Client |
| History | getHistory() Возвращает экземпляр History. | из Client |
| CookieJar | getCookieJar() Возвращает экземпляр CookieJar. | из Client |
| Crawler|null | getCrawler() Возвращает текущий экземпляр Crawler. | из Client |
| Response|null | getInternalResponse() Возвращает текущий экземпляр Response BrowserKit. | из Client |
| object|null | getResponse() Возвращает текущий исходный экземпляр ответа. | из Client |
| Request|null | getInternalRequest() Возвращает текущий экземпляр запроса BrowserKit. | из Client |
| object|null | getRequest() Возвращает текущий исходный экземпляр запроса. | из Client |
| Crawler | click(Link $link) Нажимает на заданную ссылку. | из Client |
| Crawler | submit(Form $form, array $values = array()) Отправляет форму. | из Client |
| Crawler | request(string $method, string $uri, array $parameters = array(), array $files = array(), array $server = array(), string $content = null, bool $changeHistory = true) Вызывает URI. | из Client |
| Crawler | back() Возвращается назад в истории браузера. | из Client |
| Crawler | forward() Переходит вперёд в истории браузера. | из Client |
| Crawler | reload() Перезагружает текущий браузер. | из Client |
| Crawler | followRedirect() Следовать перенаправлениям? | из Client |
| restart() Перезапускает клиент. | из Client | |
| ContainerInterface|null | getContainer() Возвращает контейнер. | |
| KernelInterface | getKernel() Возвращает ядро. | |
| Profile | getProfile() Получает профиль, связанный с текущим ответом. | |
| enableProfiler() Включает профайлер для следующего запроса. | ||
| disableReboot() Отключает перезапуск ядра между запросами. | ||
| enableReboot() Включает перезапуск ядра между запросами. |
Подробности
__construct(HttpKernelInterface $kernel, array $server = array(), History $history = null, CookieJar $cookieJar = null)
Конструктор.
Параметры
| HttpKernelInterface | $kernel | Экземпляр HttpKernel |
| array | $server | Параметры сервера (эквивалент $_SERVER) |
| History | $history | Экземпляр History для хранения истории браузера |
| CookieJar | $cookieJar | Экземпляр CookieJar для хранения cookie |
followRedirects(bool $followRedirect = true)
Устанавливает, следует ли автоматически перенаправлять или нет.
Параметры
| bool | $followRedirect | Следовать ли перенаправлениям |
setMaxRedirects(int $maxRedirects)
Устанавливает максимальное количество запросов, которые может следовать робот.
Параметры
| int | $maxRedirects |
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()
Возвращает текущий экземпляр исходного ответа.
Исходный ответ — это экземпляр ответа, возвращаемый кодом, обрабатывающим запросы.
Возвращаемое значение
| object|null | Экземпляр ответа |
Request|null getInternalRequest()
Возвращает текущий экземпляр запроса от BrowserKit.
Возвращаемое значение
| Request|null | Экземпляр запроса от BrowserKit |
object|null getRequest()
Возвращает текущий экземпляр исходного запроса.
Исходный запрос — это экземпляр запроса, отправляемый коду, обрабатывающему запросы.
Возвращаемое значение
| object|null | Экземпляр запроса |
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()) |
Возвращаемое значение
| Crawler |
Crawler back()
Возвращается в истории браузера.
Возвращаемое значение
| Crawler |
Crawler forward()
Переходит вперёд в истории браузера.
Возвращаемое значение
| Crawler |
Crawler reload()
Перезагружает текущий браузер.
Возвращаемое значение
| Crawler |
Crawler followRedirect()
Следовать перенаправлениям?
Возвращаемое значение
| Crawler |
Исключения
| LogicException | Если запрос не был перенаправлением |
restart()
Перезапускает клиента.
Очищает историю и все cookie.
ContainerInterface|null getContainer()
Возвращает контейнер.
Возвращаемое значение
| ContainerInterface|null | Возвращает null, когда ядро остановлено или ещё не запущено |
KernelInterface getKernel()
Возвращает ядро.
Значение возврата
| KernelInterface |
Profile getProfile()
Получает профиль, связанный с текущим ответом.
Значение возврата
| Profile | Экземпляр Profile |
enableProfiler()
Включает профайлер для следующего запроса.
Если профайлер уже включен, вызов этого метода ничего не делает.
disableReboot()
Отключает перезагрузку ядра между запросами.
По умолчанию, клиент перезагружает ядро для каждого запроса. Этот метод позволяет сохранить одно и то же ядро между запросами.
enableReboot()
Включает перезагрузку ядра между запросами.
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Bundle/FrameworkBundle/Client.html