[Summary view] [Print] [Text view]

   1  <?php
   2  // $Id: install.pgsql.inc,v 1.6 2007/10/22 15:22:39 dries Exp $
   3  
   4  // PostgreSQL specific install functions
   5  
   6  /**
   7   * Check if PostgreSQL is available.
   8   *
   9   * @return
  10   *  TRUE/FALSE
  11   */
  12  function pgsql_is_available() {
  13    return function_exists('pg_connect');
  14  }
  15  
  16  /**
  17   * Check if we can connect to PostgreSQL.
  18   *
  19   * @return
  20   *  TRUE/FALSE
  21   */
  22  function drupal_test_pgsql($url, &$success) {
  23    if (!pgsql_is_available()) {
  24      drupal_set_message(st('PHP PostgreSQL support not enabled.'), 'error');
  25      return FALSE;
  26    }
  27  
  28    $url = parse_url($url);
  29    $conn_string = '';
  30  
  31    // Decode url-encoded information in the db connection string
  32    if (isset($url['user'])) {
  33      $conn_string .= ' user='. urldecode($url['user']);
  34    }
  35    if (isset($url['pass'])) {
  36      $conn_string .= ' password='. urldecode($url['pass']);
  37    }
  38    if (isset($url['host'])) {
  39      $conn_string .= ' host='. urldecode($url['host']);
  40    }
  41    if (isset($url['path'])) {
  42      $conn_string .= ' dbname='. substr(urldecode($url['path']), 1);
  43    }
  44    if (isset($url['port'])) {
  45      $conn_string .= ' port='. urldecode($url['port']);
  46    }
  47  
  48    // Test connecting to the database.
  49    $connection = @pg_connect($conn_string);
  50    if (!$connection) {
  51      drupal_set_message(st('Failed to connect to your PostgreSQL database server. PostgreSQL reports the following message: %error.<ul><li>Are you sure you have the correct username and password?</li><li>Are you sure that you have typed the correct database hostname?</li><li>Are you sure that the database server is running?</li><li>Are you sure you typed the correct database name?</li></ul>For more help, see the <a href="http://drupal.org/node/258">Installation and upgrading handbook</a>. If you are unsure what these terms mean you should probably contact your hosting provider.', array('%error' => 'Connection failed. See log file for failure reason')), 'error');
  52      return FALSE;
  53    }
  54  
  55    $success = array('CONNECT');
  56  
  57    // Test CREATE.
  58    $query = 'CREATE TABLE drupal_install_test (id integer NOT NULL)';
  59    $result = pg_query($connection, $query);
  60    if ($error = pg_result_error($result)) {
  61      drupal_set_message(st('Failed to create a test table on your PostgreSQL database server with the command %query. PostgreSQL reports the following message: %error.<ul><li>Are you sure the configured username has the necessary PostgreSQL permissions to create tables in the database?</li></ul>For more help, see the <a href="http://drupal.org/node/258">Installation and upgrading handbook</a>. If you are unsure what these terms mean you should probably contact your hosting provider.', array('%query' => $query, '%error' => $error)), 'error');
  62      return FALSE;
  63    }
  64    $err = FALSE;
  65    $success[] = 'SELECT';
  66    $success[] = 'CREATE';
  67  
  68    // Test INSERT.
  69    $query = 'INSERT INTO drupal_install_test (id) VALUES (1)';
  70    $result = pg_query($connection, $query);
  71    if ($error = pg_result_error($result)) {
  72      drupal_set_message(st('Failed to insert a value into a test table on your PostgreSQL database server. We tried inserting a value with the command %query and PostgreSQL reported the following error: %error.', array('%query' => $query, '%error' => $error)), 'error');
  73      $err = TRUE;
  74    }
  75    else {
  76      $success[] = 'INSERT';
  77    }
  78  
  79    // Test UPDATE.
  80    $query = 'UPDATE drupal_install_test SET id = 2';
  81    $result = pg_query($connection, $query);
  82    if ($error = pg_result_error($result)) {
  83      drupal_set_message(st('Failed to update a value in a test table on your PostgreSQL database server. We tried updating a value with the command %query and PostgreSQL reported the following error: %error.', array('%query' => $query, '%error' => $error)), 'error');
  84      $err = TRUE;
  85    }
  86    else {
  87      $success[] = 'UPDATE';
  88    }
  89  
  90    // Test LOCK.
  91    $query = 'BEGIN; LOCK drupal_install_test IN SHARE ROW EXCLUSIVE MODE';
  92    $result = pg_query($connection, $query);
  93    if ($error = pg_result_error($result)) {
  94      drupal_set_message(st('Failed to lock a test table on your PostgreSQL database server. We tried locking a table with the command %query and PostgreSQL reported the following error: %error.', array('%query' => $query, '%error' => $error)), 'error');
  95      $err = TRUE;
  96    }
  97    else {
  98      $success[] = 'LOCK';
  99    }
 100  
 101    // Test UNLOCK, which is done automatically upon transaction end in PostgreSQL
 102    $query = 'COMMIT';
 103    $result = pg_query($connection, $query);
 104    if ($error = pg_result_error()) {
 105      drupal_set_message(st('Failed to unlock a test table on your PostgreSQL database server. We tried unlocking a table with the command %query and PostgreSQL reported the following error: %error.', array('%query' => $query, '%error' => $error)), 'error');
 106      $err = TRUE;
 107    }
 108    else {
 109      $success[] = 'UNLOCK';
 110    }
 111  
 112    // Test DELETE.
 113    $query = 'DELETE FROM drupal_install_test';
 114    $result = pg_query($connection, $query);
 115    if ($error = pg_result_error()) {
 116      drupal_set_message(st('Failed to delete a value from a test table on your PostgreSQL database server. We tried deleting a value with the command %query and PostgreSQL reported the following error: %error.', array('%query' => $query, '%error' => $error)), 'error');
 117      $err = TRUE;
 118    }
 119    else {
 120      $success[] = 'DELETE';
 121    }
 122  
 123    // Test DROP.
 124    $query = 'DROP TABLE drupal_install_test';
 125    $result = pg_query($connection, $query);
 126    if ($error = pg_result_error()) {
 127      drupal_set_message(st('Failed to drop a test table from your PostgreSQL database server. We tried dropping a table with the command %query and PostgreSQL reported the following error %error.', array('%query' => $query, '%error' => $error)), 'error');
 128      $err = TRUE;
 129    }
 130    else {
 131      $success[] = 'DROP';
 132    }
 133  
 134    if ($err) {
 135      return FALSE;
 136    }
 137  
 138    pg_close($connection);
 139    return TRUE;
 140  }