CurlServiceInterface.php 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. <?php
  2. /**
  3. * Copyright 2012-2017 Anthon Pang. All Rights Reserved.
  4. *
  5. * Licensed under the Apache License, Version 2.0 (the "License");
  6. * you may not use this file except in compliance with the License.
  7. * You may obtain a copy of the License at
  8. *
  9. * http://www.apache.org/licenses/LICENSE-2.0
  10. *
  11. * Unless required by applicable law or agreed to in writing, software
  12. * distributed under the License is distributed on an "AS IS" BASIS,
  13. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14. * See the License for the specific language governing permissions and
  15. * limitations under the License.
  16. *
  17. * @package WebDriver
  18. *
  19. * @author Anthon Pang <apang@softwaredevelopment.ca>
  20. */
  21. namespace WebDriver\Service;
  22. /**
  23. * WebDriver\Service\CurlServiceInterface class
  24. *
  25. * @package WebDriver
  26. */
  27. interface CurlServiceInterface
  28. {
  29. /**
  30. * Send protocol request to WebDriver server using curl extension API.
  31. *
  32. * @param string $requestMethod HTTP request method, e.g., 'GET', 'POST', or 'DELETE'
  33. * @param string $url Request URL
  34. * @param array $parameters If an array(), they will be posted as JSON parameters
  35. * If a number or string, "/$params" is appended to url
  36. * @param array $extraOptions key=>value pairs of curl options to pass to curl_setopt()
  37. *
  38. * @return array
  39. *
  40. * @throws \WebDriver\Exception\CurlExec only if http error and CURLOPT_FAILONERROR has been set in extraOptions
  41. */
  42. public function execute($requestMethod, $url, $parameters = null, $extraOptions = array());
  43. }