123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343 |
- <?php
- // Copyright 2004-present Facebook. All Rights Reserved.
- //
- // Licensed under the Apache License, Version 2.0 (the "License");
- // you may not use this file except in compliance with the License.
- // You may obtain a copy of the License at
- //
- // http://www.apache.org/licenses/LICENSE-2.0
- //
- // Unless required by applicable law or agreed to in writing, software
- // distributed under the License is distributed on an "AS IS" BASIS,
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- // See the License for the specific language governing permissions and
- // limitations under the License.
- namespace Facebook\WebDriver\Remote;
- use BadMethodCallException;
- use Facebook\WebDriver\Exception\WebDriverCurlException;
- use Facebook\WebDriver\Exception\WebDriverException;
- use Facebook\WebDriver\WebDriverCommandExecutor;
- use InvalidArgumentException;
- /**
- * Command executor talking to the standalone server via HTTP.
- */
- class HttpCommandExecutor implements WebDriverCommandExecutor
- {
- const DEFAULT_HTTP_HEADERS = [
- 'Content-Type: application/json;charset=UTF-8',
- 'Accept: application/json',
- ];
- /**
- * @see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#command-reference
- */
- protected static $commands = [
- DriverCommand::ACCEPT_ALERT => ['method' => 'POST', 'url' => '/session/:sessionId/accept_alert'],
- DriverCommand::ADD_COOKIE => ['method' => 'POST', 'url' => '/session/:sessionId/cookie'],
- DriverCommand::CLEAR_ELEMENT => ['method' => 'POST', 'url' => '/session/:sessionId/element/:id/clear'],
- DriverCommand::CLICK_ELEMENT => ['method' => 'POST', 'url' => '/session/:sessionId/element/:id/click'],
- DriverCommand::CLOSE => ['method' => 'DELETE', 'url' => '/session/:sessionId/window'],
- DriverCommand::DELETE_ALL_COOKIES => ['method' => 'DELETE', 'url' => '/session/:sessionId/cookie'],
- DriverCommand::DELETE_COOKIE => ['method' => 'DELETE', 'url' => '/session/:sessionId/cookie/:name'],
- DriverCommand::DISMISS_ALERT => ['method' => 'POST', 'url' => '/session/:sessionId/dismiss_alert'],
- DriverCommand::ELEMENT_EQUALS => ['method' => 'GET', 'url' => '/session/:sessionId/element/:id/equals/:other'],
- DriverCommand::FIND_CHILD_ELEMENT => ['method' => 'POST', 'url' => '/session/:sessionId/element/:id/element'],
- DriverCommand::FIND_CHILD_ELEMENTS => ['method' => 'POST', 'url' => '/session/:sessionId/element/:id/elements'],
- DriverCommand::EXECUTE_SCRIPT => ['method' => 'POST', 'url' => '/session/:sessionId/execute'],
- DriverCommand::EXECUTE_ASYNC_SCRIPT => ['method' => 'POST', 'url' => '/session/:sessionId/execute_async'],
- DriverCommand::FIND_ELEMENT => ['method' => 'POST', 'url' => '/session/:sessionId/element'],
- DriverCommand::FIND_ELEMENTS => ['method' => 'POST', 'url' => '/session/:sessionId/elements'],
- DriverCommand::SWITCH_TO_FRAME => ['method' => 'POST', 'url' => '/session/:sessionId/frame'],
- DriverCommand::SWITCH_TO_WINDOW => ['method' => 'POST', 'url' => '/session/:sessionId/window'],
- DriverCommand::GET => ['method' => 'POST', 'url' => '/session/:sessionId/url'],
- DriverCommand::GET_ACTIVE_ELEMENT => ['method' => 'POST', 'url' => '/session/:sessionId/element/active'],
- DriverCommand::GET_ALERT_TEXT => ['method' => 'GET', 'url' => '/session/:sessionId/alert_text'],
- DriverCommand::GET_ALL_COOKIES => ['method' => 'GET', 'url' => '/session/:sessionId/cookie'],
- DriverCommand::GET_ALL_SESSIONS => ['method' => 'GET', 'url' => '/sessions'],
- DriverCommand::GET_AVAILABLE_LOG_TYPES => ['method' => 'GET', 'url' => '/session/:sessionId/log/types'],
- DriverCommand::GET_CURRENT_URL => ['method' => 'GET', 'url' => '/session/:sessionId/url'],
- DriverCommand::GET_CURRENT_WINDOW_HANDLE => ['method' => 'GET', 'url' => '/session/:sessionId/window_handle'],
- DriverCommand::GET_ELEMENT_ATTRIBUTE => [
- 'method' => 'GET',
- 'url' => '/session/:sessionId/element/:id/attribute/:name',
- ],
- DriverCommand::GET_ELEMENT_VALUE_OF_CSS_PROPERTY => [
- 'method' => 'GET',
- 'url' => '/session/:sessionId/element/:id/css/:propertyName',
- ],
- DriverCommand::GET_ELEMENT_LOCATION => [
- 'method' => 'GET',
- 'url' => '/session/:sessionId/element/:id/location',
- ],
- DriverCommand::GET_ELEMENT_LOCATION_ONCE_SCROLLED_INTO_VIEW => [
- 'method' => 'GET',
- 'url' => '/session/:sessionId/element/:id/location_in_view',
- ],
- DriverCommand::GET_ELEMENT_SIZE => ['method' => 'GET', 'url' => '/session/:sessionId/element/:id/size'],
- DriverCommand::GET_ELEMENT_TAG_NAME => ['method' => 'GET', 'url' => '/session/:sessionId/element/:id/name'],
- DriverCommand::GET_ELEMENT_TEXT => ['method' => 'GET', 'url' => '/session/:sessionId/element/:id/text'],
- DriverCommand::GET_LOG => ['method' => 'POST', 'url' => '/session/:sessionId/log'],
- DriverCommand::GET_PAGE_SOURCE => ['method' => 'GET', 'url' => '/session/:sessionId/source'],
- DriverCommand::GET_SCREEN_ORIENTATION => ['method' => 'GET', 'url' => '/session/:sessionId/orientation'],
- DriverCommand::GET_CAPABILITIES => ['method' => 'GET', 'url' => '/session/:sessionId'],
- DriverCommand::GET_TITLE => ['method' => 'GET', 'url' => '/session/:sessionId/title'],
- DriverCommand::GET_WINDOW_HANDLES => ['method' => 'GET', 'url' => '/session/:sessionId/window_handles'],
- DriverCommand::GET_WINDOW_POSITION => [
- 'method' => 'GET',
- 'url' => '/session/:sessionId/window/:windowHandle/position',
- ],
- DriverCommand::GET_WINDOW_SIZE => ['method' => 'GET', 'url' => '/session/:sessionId/window/:windowHandle/size'],
- DriverCommand::GO_BACK => ['method' => 'POST', 'url' => '/session/:sessionId/back'],
- DriverCommand::GO_FORWARD => ['method' => 'POST', 'url' => '/session/:sessionId/forward'],
- DriverCommand::IS_ELEMENT_DISPLAYED => [
- 'method' => 'GET',
- 'url' => '/session/:sessionId/element/:id/displayed',
- ],
- DriverCommand::IS_ELEMENT_ENABLED => ['method' => 'GET', 'url' => '/session/:sessionId/element/:id/enabled'],
- DriverCommand::IS_ELEMENT_SELECTED => ['method' => 'GET', 'url' => '/session/:sessionId/element/:id/selected'],
- DriverCommand::MAXIMIZE_WINDOW => [
- 'method' => 'POST',
- 'url' => '/session/:sessionId/window/:windowHandle/maximize',
- ],
- DriverCommand::MOUSE_DOWN => ['method' => 'POST', 'url' => '/session/:sessionId/buttondown'],
- DriverCommand::MOUSE_UP => ['method' => 'POST', 'url' => '/session/:sessionId/buttonup'],
- DriverCommand::CLICK => ['method' => 'POST', 'url' => '/session/:sessionId/click'],
- DriverCommand::DOUBLE_CLICK => ['method' => 'POST', 'url' => '/session/:sessionId/doubleclick'],
- DriverCommand::MOVE_TO => ['method' => 'POST', 'url' => '/session/:sessionId/moveto'],
- DriverCommand::NEW_SESSION => ['method' => 'POST', 'url' => '/session'],
- DriverCommand::QUIT => ['method' => 'DELETE', 'url' => '/session/:sessionId'],
- DriverCommand::REFRESH => ['method' => 'POST', 'url' => '/session/:sessionId/refresh'],
- DriverCommand::UPLOAD_FILE => ['method' => 'POST', 'url' => '/session/:sessionId/file'], // undocumented
- DriverCommand::SEND_KEYS_TO_ACTIVE_ELEMENT => ['method' => 'POST', 'url' => '/session/:sessionId/keys'],
- DriverCommand::SET_ALERT_VALUE => ['method' => 'POST', 'url' => '/session/:sessionId/alert_text'],
- DriverCommand::SEND_KEYS_TO_ELEMENT => ['method' => 'POST', 'url' => '/session/:sessionId/element/:id/value'],
- DriverCommand::IMPLICITLY_WAIT => ['method' => 'POST', 'url' => '/session/:sessionId/timeouts/implicit_wait'],
- DriverCommand::SET_SCREEN_ORIENTATION => ['method' => 'POST', 'url' => '/session/:sessionId/orientation'],
- DriverCommand::SET_TIMEOUT => ['method' => 'POST', 'url' => '/session/:sessionId/timeouts'],
- DriverCommand::SET_SCRIPT_TIMEOUT => ['method' => 'POST', 'url' => '/session/:sessionId/timeouts/async_script'],
- DriverCommand::SET_WINDOW_POSITION => [
- 'method' => 'POST',
- 'url' => '/session/:sessionId/window/:windowHandle/position',
- ],
- DriverCommand::SET_WINDOW_SIZE => [
- 'method' => 'POST',
- 'url' => '/session/:sessionId/window/:windowHandle/size',
- ],
- DriverCommand::SUBMIT_ELEMENT => ['method' => 'POST', 'url' => '/session/:sessionId/element/:id/submit'],
- DriverCommand::SCREENSHOT => ['method' => 'GET', 'url' => '/session/:sessionId/screenshot'],
- DriverCommand::TOUCH_SINGLE_TAP => ['method' => 'POST', 'url' => '/session/:sessionId/touch/click'],
- DriverCommand::TOUCH_DOWN => ['method' => 'POST', 'url' => '/session/:sessionId/touch/down'],
- DriverCommand::TOUCH_DOUBLE_TAP => ['method' => 'POST', 'url' => '/session/:sessionId/touch/doubleclick'],
- DriverCommand::TOUCH_FLICK => ['method' => 'POST', 'url' => '/session/:sessionId/touch/flick'],
- DriverCommand::TOUCH_LONG_PRESS => ['method' => 'POST', 'url' => '/session/:sessionId/touch/longclick'],
- DriverCommand::TOUCH_MOVE => ['method' => 'POST', 'url' => '/session/:sessionId/touch/move'],
- DriverCommand::TOUCH_SCROLL => ['method' => 'POST', 'url' => '/session/:sessionId/touch/scroll'],
- DriverCommand::TOUCH_UP => ['method' => 'POST', 'url' => '/session/:sessionId/touch/up'],
- ];
- /**
- * @var string
- */
- protected $url;
- /**
- * @var resource
- */
- protected $curl;
- /**
- * @param string $url
- * @param string|null $http_proxy
- * @param int|null $http_proxy_port
- */
- public function __construct($url, $http_proxy = null, $http_proxy_port = null)
- {
- $this->url = $url;
- $this->curl = curl_init();
- if (!empty($http_proxy)) {
- curl_setopt($this->curl, CURLOPT_PROXY, $http_proxy);
- if ($http_proxy_port !== null) {
- curl_setopt($this->curl, CURLOPT_PROXYPORT, $http_proxy_port);
- }
- }
- // Get credentials from $url (if any)
- $matches = null;
- if (preg_match("/^(https?:\/\/)(.*):(.*)@(.*?)/U", $url, $matches)) {
- $this->url = $matches[1] . $matches[4];
- $auth_creds = $matches[2] . ':' . $matches[3];
- curl_setopt($this->curl, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
- curl_setopt($this->curl, CURLOPT_USERPWD, $auth_creds);
- }
- curl_setopt($this->curl, CURLOPT_RETURNTRANSFER, true);
- curl_setopt($this->curl, CURLOPT_FOLLOWLOCATION, true);
- curl_setopt($this->curl, CURLOPT_HTTPHEADER, static::DEFAULT_HTTP_HEADERS);
- $this->setRequestTimeout(30000);
- $this->setConnectionTimeout(30000);
- }
- /**
- * Set timeout for the connect phase
- *
- * @param int $timeout_in_ms Timeout in milliseconds
- * @return HttpCommandExecutor
- */
- public function setConnectionTimeout($timeout_in_ms)
- {
- // There is a PHP bug in some versions which didn't define the constant.
- curl_setopt(
- $this->curl,
- /* CURLOPT_CONNECTTIMEOUT_MS */
- 156,
- $timeout_in_ms
- );
- return $this;
- }
- /**
- * Set the maximum time of a request
- *
- * @param int $timeout_in_ms Timeout in milliseconds
- * @return HttpCommandExecutor
- */
- public function setRequestTimeout($timeout_in_ms)
- {
- // There is a PHP bug in some versions (at least for PHP 5.3.3) which
- // didn't define the constant.
- curl_setopt(
- $this->curl,
- /* CURLOPT_TIMEOUT_MS */
- 155,
- $timeout_in_ms
- );
- return $this;
- }
- /**
- * @param WebDriverCommand $command
- *
- * @throws WebDriverException
- * @return WebDriverResponse
- */
- public function execute(WebDriverCommand $command)
- {
- if (!isset(self::$commands[$command->getName()])) {
- throw new InvalidArgumentException($command->getName() . ' is not a valid command.');
- }
- $raw = self::$commands[$command->getName()];
- $http_method = $raw['method'];
- $url = $raw['url'];
- $url = str_replace(':sessionId', $command->getSessionID(), $url);
- $params = $command->getParameters();
- foreach ($params as $name => $value) {
- if ($name[0] === ':') {
- $url = str_replace($name, $value, $url);
- unset($params[$name]);
- }
- }
- if ($params && is_array($params) && $http_method !== 'POST') {
- throw new BadMethodCallException(sprintf(
- 'The http method called for %s is %s but it has to be POST' .
- ' if you want to pass the JSON params %s',
- $url,
- $http_method,
- json_encode($params)
- ));
- }
- curl_setopt($this->curl, CURLOPT_URL, $this->url . $url);
- // https://github.com/facebook/php-webdriver/issues/173
- if ($command->getName() === DriverCommand::NEW_SESSION) {
- curl_setopt($this->curl, CURLOPT_POST, 1);
- } else {
- curl_setopt($this->curl, CURLOPT_CUSTOMREQUEST, $http_method);
- }
- if (in_array($http_method, ['POST', 'PUT'])) {
- // Disable sending 'Expect: 100-Continue' header, as it is causing issues with eg. squid proxy
- // https://tools.ietf.org/html/rfc7231#section-5.1.1
- curl_setopt($this->curl, CURLOPT_HTTPHEADER, array_merge(static::DEFAULT_HTTP_HEADERS, ['Expect:']));
- } else {
- curl_setopt($this->curl, CURLOPT_HTTPHEADER, static::DEFAULT_HTTP_HEADERS);
- }
- $encoded_params = null;
- if ($http_method === 'POST' && $params && is_array($params)) {
- $encoded_params = json_encode($params);
- }
- curl_setopt($this->curl, CURLOPT_POSTFIELDS, $encoded_params);
- $raw_results = trim(curl_exec($this->curl));
- if ($error = curl_error($this->curl)) {
- $msg = sprintf(
- 'Curl error thrown for http %s to %s',
- $http_method,
- $url
- );
- if ($params && is_array($params)) {
- $msg .= sprintf(' with params: %s', json_encode($params));
- }
- throw new WebDriverCurlException($msg . "\n\n" . $error);
- }
- $results = json_decode($raw_results, true);
- if ($results === null && json_last_error() !== JSON_ERROR_NONE) {
- throw new WebDriverException(
- sprintf(
- "JSON decoding of remote response failed.\n" .
- "Error code: %d\n" .
- "The response: '%s'\n",
- json_last_error(),
- $raw_results
- )
- );
- }
- $value = null;
- if (is_array($results) && array_key_exists('value', $results)) {
- $value = $results['value'];
- }
- $message = null;
- if (is_array($value) && array_key_exists('message', $value)) {
- $message = $value['message'];
- }
- $sessionId = null;
- if (is_array($results) && array_key_exists('sessionId', $results)) {
- $sessionId = $results['sessionId'];
- }
- $status = isset($results['status']) ? $results['status'] : 0;
- if ($status != 0) {
- WebDriverException::throwException($status, $message, $results);
- }
- $response = new WebDriverResponse($sessionId);
- return $response
- ->setStatus($status)
- ->setValue($value);
- }
- /**
- * @return string
- */
- public function getAddressOfRemoteServer()
- {
- return $this->url;
- }
- }
|