122 lines
3.9 KiB
PHP
122 lines
3.9 KiB
PHP
<?php
|
|
// $Id$
|
|
|
|
/**
|
|
* @file
|
|
* Database interface code for PostgreSQL database servers.
|
|
*/
|
|
|
|
/**
|
|
* @ingroup database
|
|
* @{
|
|
*/
|
|
|
|
class DatabaseConnection_pgsql extends DatabaseConnection {
|
|
|
|
public function __construct(array $connection_options = array()) {
|
|
// This driver defaults to transaction support, except if explicitly passed FALSE.
|
|
$this->transactionSupport = !isset($connection_options['transactions']) || ($connection_options['transactions'] !== FALSE);
|
|
|
|
// Transactional DDL is always available in PostgreSQL,
|
|
// but we'll only enable it if standard transactions are.
|
|
$this->transactionalDDLSupport = $this->transactionSupport;
|
|
|
|
// Default to TCP connection on port 5432.
|
|
if (empty($connection_options['port'])) {
|
|
$connection_options['port'] = 5432;
|
|
}
|
|
|
|
$dsn = 'pgsql:host=' . $connection_options['host'] . ' dbname=' . $connection_options['database'] . ' port=' . $connection_options['port'];
|
|
parent::__construct($dsn, $connection_options['username'], $connection_options['password'], array(
|
|
// Convert numeric values to strings when fetching.
|
|
PDO::ATTR_STRINGIFY_FETCHES => TRUE,
|
|
// Force column names to lower case.
|
|
PDO::ATTR_CASE => PDO::CASE_LOWER,
|
|
));
|
|
}
|
|
|
|
public function query($query, array $args = array(), $options = array()) {
|
|
|
|
$options += $this->defaultOptions();
|
|
|
|
try {
|
|
if ($query instanceof DatabaseStatementInterface) {
|
|
$stmt = $query;
|
|
$stmt->execute(NULL, $options);
|
|
}
|
|
else {
|
|
$modified = $this->expandArguments($query, $args);
|
|
$stmt = $this->prepareQuery($query, !$modified);
|
|
$stmt->execute($args, $options);
|
|
}
|
|
|
|
switch ($options['return']) {
|
|
case Database::RETURN_STATEMENT:
|
|
return $stmt;
|
|
case Database::RETURN_AFFECTED:
|
|
return $stmt->rowCount();
|
|
case Database::RETURN_INSERT_ID:
|
|
return $this->lastInsertId($options['sequence_name']);
|
|
case Database::RETURN_NULL:
|
|
return;
|
|
default:
|
|
throw new PDOException('Invalid return directive: ' . $options['return']);
|
|
}
|
|
}
|
|
catch (PDOException $e) {
|
|
_db_check_install_needed();
|
|
if ($options['throw_exception']) {
|
|
if ($query instanceof DatabaseStatementInterface) {
|
|
$query_string = $stmt->getQueryString();
|
|
}
|
|
else {
|
|
$query_string = $query;
|
|
}
|
|
throw new PDOException($query_string . " - \n" . print_r($args,1) . $e->getMessage());
|
|
}
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
public function queryRange($query, array $args, $from, $count, array $options = array()) {
|
|
return $this->query($query . ' LIMIT ' . $count . ' OFFSET ' . $from, $args, $options);
|
|
}
|
|
|
|
public function queryTemporary($query, array $args, array $options = array()) {
|
|
$tablename = $this->generateTemporaryTableName();
|
|
$this->query(preg_replace('/^SELECT/i', 'CREATE TEMPORARY TABLE {' . $tablename . '} AS SELECT', $query), $args, $options);
|
|
return $tablename;
|
|
}
|
|
|
|
public function driver() {
|
|
return 'pgsql';
|
|
}
|
|
|
|
public function databaseType() {
|
|
return 'pgsql';
|
|
}
|
|
|
|
public function mapConditionOperator($operator) {
|
|
static $specials = array(
|
|
// In PostgreSQL, 'LIKE' is case-sensitive. For case-insensitive LIKE
|
|
// statements, we need to use ILIKE instead.
|
|
'LIKE' => array('operator' => 'ILIKE'),
|
|
);
|
|
|
|
return isset($specials[$operator]) ? $specials[$operator] : NULL;
|
|
}
|
|
|
|
/**
|
|
* @todo Remove this as soon as db_rewrite_sql() has been exterminated.
|
|
*/
|
|
public function distinctField($table, $field, $query) {
|
|
$field_to_select = 'DISTINCT(' . $table . '.' . $field . ')';
|
|
// (?<!text) is a negative look-behind (no need to rewrite queries that already use DISTINCT).
|
|
return preg_replace('/(SELECT.*)(?:' . $table . '\.|\s)(?<!DISTINCT\()(?<!DISTINCT\(' . $table . '\.)' . $field . '(.*FROM )/AUsi', '\1 ' . $field_to_select . '\2', $query);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @} End of "ingroup database".
|
|
*/
|