webmaster@1: <?php
webmaster@1: // $Id: install.pgsql.inc,v 1.6 2007/10/22 15:22:39 dries Exp $
webmaster@1: 
webmaster@1: // PostgreSQL specific install functions
webmaster@1: 
webmaster@1: /**
webmaster@1:  * Check if PostgreSQL is available.
webmaster@1:  *
webmaster@1:  * @return
webmaster@1:  *  TRUE/FALSE
webmaster@1:  */
webmaster@1: function pgsql_is_available() {
webmaster@1:   return function_exists('pg_connect');
webmaster@1: }
webmaster@1: 
webmaster@1: /**
webmaster@1:  * Check if we can connect to PostgreSQL.
webmaster@1:  *
webmaster@1:  * @return
webmaster@1:  *  TRUE/FALSE
webmaster@1:  */
webmaster@1: function drupal_test_pgsql($url, &$success) {
webmaster@1:   if (!pgsql_is_available()) {
webmaster@1:     drupal_set_message(st('PHP PostgreSQL support not enabled.'), 'error');
webmaster@1:     return FALSE;
webmaster@1:   }
webmaster@1: 
webmaster@1:   $url = parse_url($url);
webmaster@1:   $conn_string = '';
webmaster@1: 
webmaster@1:   // Decode url-encoded information in the db connection string
webmaster@1:   if (isset($url['user'])) {
webmaster@1:     $conn_string .= ' user='. urldecode($url['user']);
webmaster@1:   }
webmaster@1:   if (isset($url['pass'])) {
webmaster@1:     $conn_string .= ' password='. urldecode($url['pass']);
webmaster@1:   }
webmaster@1:   if (isset($url['host'])) {
webmaster@1:     $conn_string .= ' host='. urldecode($url['host']);
webmaster@1:   }
webmaster@1:   if (isset($url['path'])) {
webmaster@1:     $conn_string .= ' dbname='. substr(urldecode($url['path']), 1);
webmaster@1:   }
webmaster@1:   if (isset($url['port'])) {
webmaster@1:     $conn_string .= ' port='. urldecode($url['port']);
webmaster@1:   }
webmaster@1: 
webmaster@1:   // Test connecting to the database.
webmaster@1:   $connection = @pg_connect($conn_string);
webmaster@1:   if (!$connection) {
webmaster@1:     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');
webmaster@1:     return FALSE;
webmaster@1:   }
webmaster@1: 
webmaster@1:   $success = array('CONNECT');
webmaster@1: 
webmaster@1:   // Test CREATE.
webmaster@1:   $query = 'CREATE TABLE drupal_install_test (id integer NOT NULL)';
webmaster@1:   $result = pg_query($connection, $query);
webmaster@1:   if ($error = pg_result_error($result)) {
webmaster@1:     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');
webmaster@1:     return FALSE;
webmaster@1:   }
webmaster@1:   $err = FALSE;
webmaster@1:   $success[] = 'SELECT';
webmaster@1:   $success[] = 'CREATE';
webmaster@1: 
webmaster@1:   // Test INSERT.
webmaster@1:   $query = 'INSERT INTO drupal_install_test (id) VALUES (1)';
webmaster@1:   $result = pg_query($connection, $query);
webmaster@1:   if ($error = pg_result_error($result)) {
webmaster@1:     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');
webmaster@1:     $err = TRUE;
webmaster@1:   }
webmaster@1:   else {
webmaster@1:     $success[] = 'INSERT';
webmaster@1:   }
webmaster@1: 
webmaster@1:   // Test UPDATE.
webmaster@1:   $query = 'UPDATE drupal_install_test SET id = 2';
webmaster@1:   $result = pg_query($connection, $query);
webmaster@1:   if ($error = pg_result_error($result)) {
webmaster@1:     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');
webmaster@1:     $err = TRUE;
webmaster@1:   }
webmaster@1:   else {
webmaster@1:     $success[] = 'UPDATE';
webmaster@1:   }
webmaster@1: 
webmaster@1:   // Test LOCK.
webmaster@1:   $query = 'BEGIN; LOCK drupal_install_test IN SHARE ROW EXCLUSIVE MODE';
webmaster@1:   $result = pg_query($connection, $query);
webmaster@1:   if ($error = pg_result_error($result)) {
webmaster@1:     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');
webmaster@1:     $err = TRUE;
webmaster@1:   }
webmaster@1:   else {
webmaster@1:     $success[] = 'LOCK';
webmaster@1:   }
webmaster@1: 
webmaster@1:   // Test UNLOCK, which is done automatically upon transaction end in PostgreSQL
webmaster@1:   $query = 'COMMIT';
webmaster@1:   $result = pg_query($connection, $query);
webmaster@1:   if ($error = pg_result_error()) {
webmaster@1:     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');
webmaster@1:     $err = TRUE;
webmaster@1:   }
webmaster@1:   else {
webmaster@1:     $success[] = 'UNLOCK';
webmaster@1:   }
webmaster@1: 
webmaster@1:   // Test DELETE.
webmaster@1:   $query = 'DELETE FROM drupal_install_test';
webmaster@1:   $result = pg_query($connection, $query);
webmaster@1:   if ($error = pg_result_error()) {
webmaster@1:     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');
webmaster@1:     $err = TRUE;
webmaster@1:   }
webmaster@1:   else {
webmaster@1:     $success[] = 'DELETE';
webmaster@1:   }
webmaster@1: 
webmaster@1:   // Test DROP.
webmaster@1:   $query = 'DROP TABLE drupal_install_test';
webmaster@1:   $result = pg_query($connection, $query);
webmaster@1:   if ($error = pg_result_error()) {
webmaster@1:     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');
webmaster@1:     $err = TRUE;
webmaster@1:   }
webmaster@1:   else {
webmaster@1:     $success[] = 'DROP';
webmaster@1:   }
webmaster@1: 
webmaster@1:   if ($err) {
webmaster@1:     return FALSE;
webmaster@1:   }
webmaster@1: 
webmaster@1:   pg_close($connection);
webmaster@1:   return TRUE;
webmaster@1: }