1 backdrop_web_test_case.php protected BackdropWebTestCase::curlInitialize()

Initializes the cURL connection.

If the simpletest_httpauth_credentials variable is set, this function will add HTTP authentication headers. This is necessary for testing sites that are protected by login credentials from public access. See the description of $curl_options for other options.


core/modules/simpletest/backdrop_web_test_case.php, line 1968


Test case for typical Backdrop tests.


protected function curlInitialize() {
  global $base_url;

  if (!isset($this->curlHandle)) {
    $this->curlHandle = curl_init();

    // Some versions/configurations of cURL break on a NULL cookie jar, so
    // supply a real file.
    if (empty($this->cookieFile)) {
      $this->cookieFile = $this->public_files_directory . '/cookie.jar';

    $curl_options = array(
      CURLOPT_COOKIEJAR => $this->cookieFile,
      CURLOPT_URL => $base_url,
      CURLOPT_SSL_VERIFYPEER => FALSE, // Required to make the tests run on HTTPS.
      CURLOPT_SSL_VERIFYHOST => FALSE, // Required to make the tests run on HTTPS.
      CURLOPT_HEADERFUNCTION => array(&$this, 'curlHeaderCallback'),
      CURLOPT_USERAGENT => $this->databasePrefix,
    if (isset($this->httpauth_credentials)) {
      $curl_options[CURLOPT_HTTPAUTH] = $this->httpauth_method;
      $curl_options[CURLOPT_USERPWD] = $this->httpauth_credentials;
    // curl_setopt_array() returns FALSE if any of the specified options
    // cannot be set, and stops processing any further options.
    $result = curl_setopt_array($this->curlHandle, $this->additionalCurlOptions + $curl_options);
    if (!$result) {
      throw new Exception('One or more cURL options could not be set.');

    // By default, the child session name should be the same as the parent.
    $this->session_name = session_name();
  // We set the user agent header on each request so as to use the current
  // time and a new unique ID.
  if (preg_match('/simpletest\d+/', $this->databasePrefix, $matches)) {
    curl_setopt($this->curlHandle, CURLOPT_USERAGENT, backdrop_generate_test_ua($matches[0]));