MDB2_Driver_pgsql Class Reference

Inheritance diagram for MDB2_Driver_pgsql:

Collaboration diagram for MDB2_Driver_pgsql:

Public Member Functions
	__construct ()
	Constructor. More...
	errorInfo ($error=null)
	This method is used to collect information about an error. More...
	escape ($text, $escape_wildcards=false)
	Quotes a string so it can be safely used in a query. More...
	beginTransaction ($savepoint=null)
	Start a transaction or set a savepoint. More...
	commit ($savepoint=null)
	Commit the database changes done during a transaction that is in progress or release a savepoint. More...
	rollback ($savepoint=null)
	Cancel any database changes done during a transaction or since a specific savepoint that is in progress. More...
	setTransactionIsolation ($isolation)
	Set the transacton isolation level. More...
	_doConnect ($database_name, $persistent=false)
	Does the grunt work of connecting to the database. More...
	connect ()
	Connect to the database. More...
	setCharset ($charset, $connection=null)
	Set the charset on the current connection. More...
	disconnect ($force=true)
	Log out and disconnect from the database. More...
&	standaloneQuery ($query, $types=null, $is_manip=false)
	execute a query as DBA More...
&	_doQuery ($query, $is_manip=false, $connection=null, $database_name=null)
	Execute a query. More...
	_affectedRows ($connection, $result=null)
	Returns the number of rows affected. More...
	_modifyQuery ($query, $is_manip, $limit, $offset)
	Changes a query string for various DBMS specific reasons. More...
	_modifyManipQuery ($query, $limit)
	Changes a manip query string for various DBMS specific reasons. More...
	getServerVersion ($native=false)
	return version information about the server More...
&	prepare ($query, $types=null, $result_types=null, $lobs=array())
	Prepares a query for multiple execution with execute(). More...
	getSequenceName ($sqn)
	adds sequence name formatting to a sequence name More...
	nextID ($seq_name, $ondemand=true)
	Returns the next free id of a sequence. More...
	lastInsertID ($table=null, $field=null)
	Returns the autoincrement ID if supported or $id or fetches the current ID in a sequence called: $table. More...
	currID ($seq_name)
	Returns the current id of a sequence. More...
Public Member Functions inherited from MDB2_Driver_Common
	__construct ()
	Constructor. More...
	MDB2_Driver_Common ()
	PHP 4 Constructor. More...
	__destruct ()
	Destructor. More...
	free ()
	Free the internal references so that the instance can be destroyed. More...
	__toString ()
	String conversation. More...
	errorInfo ($error=null)
	This method is used to collect information about an error. More...
&	raiseError ($message=null, $code=null, $mode=null, $options=null, $userinfo=null, $error_class=null, $skipmsg=false)
	This method is used to communicate an error and invoke error callbacks etc. More...
	resetWarnings ()
	reset the warning array More...
	getWarnings ()
	Get all warnings in reverse order. More...
	setFetchMode ($fetchmode, $object_class='stdClass')
	Sets which fetch mode should be used by default on queries on this connection. More...
	setOption ($option, $value)
	set the option for the db class More...
	getOption ($option)
	Returns the value of an option. More...
	debug ($message, $scope='', $context=array())
	set a debug message More...
	getDebugOutput ()
	output debug info More...
	escape ($text, $escape_wildcards=false)
	Quotes a string so it can be safely used in a query. More...
	escapePattern ($text)
	Quotes pattern (% and _) characters in a string) More...
	quoteIdentifier ($str, $check_option=false)
	Quote a string so it can be safely used as a table or column name. More...
	getAsKeyword ()
	Gets the string to alias column. More...
	getConnection ()
	Returns a native connection. More...
	_fixResultArrayValues (&$row, $mode)
	Do all necessary conversions on result arrays to fix DBMS quirks. More...
&	loadModule ($module, $property=null, $phptype_specific=null)
	loads a module More...
	__call ($method, $params)
	Calls a module method using the __call magic method. More...
	beginTransaction ($savepoint=null)
	Start a transaction or set a savepoint. More...
	commit ($savepoint=null)
	Commit the database changes done during a transaction that is in progress or release a savepoint. More...
	rollback ($savepoint=null)
	Cancel any database changes done during a transaction or since a specific savepoint that is in progress. More...
	inTransaction ($ignore_nested=false)
	If a transaction is currently open. More...
	setTransactionIsolation ($isolation, $options=array())
	Set the transacton isolation level. More...
	beginNestedTransaction ()
	Start a nested transaction. More...
	completeNestedTransaction ($force_rollback=false)
	Finish a nested transaction by rolling back if an error occured or committing otherwise. More...
	failNestedTransaction ($error=null, $immediately=false)
	Force setting nested transaction to failed. More...
	getNestedTransactionError ()
	The first error that occured since the transaction start. More...
	connect ()
	Connect to the database. More...
	setCharset ($charset, $connection=null)
	Set the charset on the current connection. More...
	disconnect ($force=true)
	Log out and disconnect from the database. More...
	setDatabase ($name)
	Select a different database. More...
	getDatabase ()
	Get the current database. More...
	setDSN ($dsn)
	set the DSN More...
	getDSN ($type='string', $hidepw=false)
	return the DSN as a string More...
&	standaloneQuery ($query, $types=null, $is_manip=false)
	execute a query as database administrator More...
	_modifyQuery ($query, $is_manip, $limit, $offset)
	Changes a query string for various DBMS specific reasons. More...
&	_doQuery ($query, $is_manip=false, $connection=null, $database_name=null)
	Execute a query. More...
	_affectedRows ($connection, $result=null)
	Returns the number of rows affected. More...
&	exec ($query)
	Execute a manipulation query to the database and return the number of affected rows. More...
&	query ($query, $types=null, $result_class=true, $result_wrap_class=false)
	Send a query to the database and return any results. More...
&	_wrapResult ($result, $types=array(), $result_class=true, $result_wrap_class=false, $limit=null, $offset=null)
	wrap a result set into the correct class More...
	getServerVersion ($native=false)
	return version information about the server More...
	setLimit ($limit, $offset=null)
	set the range of the next query More...
	subSelect ($query, $type=false)
	simple subselect emulation: leaves the query untouched for all RDBMS that support subselects More...
	replace ($table, $fields)
	Execute a SQL REPLACE query. More...
&	prepare ($query, $types=null, $result_types=null, $lobs=array())
	Prepares a query for multiple execution with execute(). More...
	_skipDelimitedStrings ($query, $position, $p_position)
	Utility method, used by prepare() to avoid replacing placeholders within delimited strings. More...
	quote ($value, $type=null, $quote=true, $escape_wildcards=false)
	Convert a text value into a DBMS specific format that is suitable to compose query statements. More...
	getDeclaration ($type, $name, $field)
	Obtain DBMS specific SQL code portion needed to declare of the given type. More...
	compareDefinition ($current, $previous)
	Obtain an array of changes that may need to applied. More...
	supports ($feature)
	Tell whether a DB implementation or its backend extension supports a given feature. More...
	getSequenceName ($sqn)
	adds sequence name formatting to a sequence name More...
	getIndexName ($idx)
	adds index name formatting to a index name More...
	nextID ($seq_name, $ondemand=true)
	Returns the next free id of a sequence. More...
	lastInsertID ($table=null, $field=null)
	Returns the autoincrement ID if supported or $id or fetches the current ID in a sequence called: $table. More...
	currID ($seq_name)
	Returns the current id of a sequence. More...
	queryOne ($query, $type=null, $colnum=0)
	Execute the specified query, fetch the value from the first column of the first row of the result set and then frees the result set. More...
	queryRow ($query, $types=null, $fetchmode=MDB2_FETCHMODE_DEFAULT)
	Execute the specified query, fetch the values from the first row of the result set into an array and then frees the result set. More...
	queryCol ($query, $type=null, $colnum=0)
	Execute the specified query, fetch the value from the first column of each row of the result set into an array and then frees the result set. More...
	queryAll ($query, $types=null, $fetchmode=MDB2_FETCHMODE_DEFAULT, $rekey=false, $force_array=false, $group=false)
	Execute the specified query, fetch all the rows of the result set into a two dimensional array and then frees the result set. More...
Public Member Functions inherited from PEAR
	__construct ($error_class=null)
	Constructor. More...
	_PEAR ()
	Destructor (the emulated type of...). More...
	registerShutdownFunc ($func, $args=array())
	Use this function to register a shutdown method for static classes. More...
	isError ($data, $code=null)
	Tell whether a value is a PEAR error. More...
	expectError ($code=' *')
	This method is used to tell which errors you expect to get. More...
	popExpect ()
	This method pops one element off the expected error codes stack. More...
	_checkDelExpect ($error_code)
	This method checks unsets an error code if available. More...
	delExpect ($error_code)
	This method deletes all occurences of the specified element from the expected error codes stack. More...
&	raiseError ($message=null, $code=null, $mode=null, $options=null, $userinfo=null, $error_class=null, $skipmsg=false)
	This method is a wrapper that returns an instance of the configured error class with this object's default error handling applied. More...
&	throwError ($message=null, $code=null, $userinfo=null)
	Simpler form of raiseError with fewer options. More...
	staticPushErrorHandling ($mode, $options=null)
	staticPopErrorHandling ()
	pushErrorHandling ($mode, $options=null)
	Push a new error handler on top of the error handler options stack. More...
	popErrorHandling ()
	Pop the last error handler used. More...
	loadExtension ($ext)
	OS independant PHP extension load. More...

Data Fields
	$string_quoting = array('start' => "'", 'end' => "'", 'escape' => "'", 'escape_pattern' => '\\')
	$identifier_quoting = array('start' => '"', 'end' => '"', 'escape' => '"')
Data Fields inherited from MDB2_Driver_Common
	$db_index = 0
	$dsn = array()
	$connected_dsn = array()
	$connection = 0
	$opened_persistent
	$database_name = ''
	$connected_database_name = ''
	$connected_server_info = ''
	$supported
	$options
	$string_quoting = array('start' => "'", 'end' => "'", 'escape' => false, 'escape_pattern' => false)
	$identifier_quoting = array('start' => '"', 'end' => '"', 'escape' => '"')
	$sql_comments
	$wildcards = array('%', '_')
	$as_keyword = ' AS '
	$warnings = array()
	$debug_output = ''
	$in_transaction = false
	$nested_transaction_counter = null
	$has_transaction_error = false
	$offset = 0
	$limit = 0
	$phptype
	$dbsyntax
	$last_query
	$fetchmode = MDB2_FETCHMODE_ORDERED
	$modules = array()
	$destructor_registered = true
Data Fields inherited from PEAR
	$_debug = false
	$_default_error_mode = null
	$_default_error_options = null
	$_default_error_handler = ''
	$_error_class = 'PEAR_Error'
	$_expected_errors = array()

Additional Inherited Members
Static Public Member Functions inherited from PEAR
static &	getStaticProperty ($class, $var)
	If you have a class that's mostly/entirely static, and you need static properties, you can use this method to simulate them. More...
static	setErrorHandling ($mode=null, $options=null)
	Sets how errors generated by this object should be handled. More...

Detailed Description

Definition at line 55 of file pgsql.php.

Constructor & Destructor Documentation

__construct()

MDB2_Driver_pgsql::__construct

(

)

Constructor.

Definition at line 67 of file pgsql.php.

    {
        parent::__construct();

        $this->phptype = 'pgsql';
        $this->dbsyntax = 'pgsql';

        $this->supported['sequences'] = true;
        $this->supported['indexes'] = true;
        $this->supported['affected_rows'] = true;
        $this->supported['summary_functions'] = true;
        $this->supported['order_by_text'] = true;
        $this->supported['transactions'] = true;
        $this->supported['savepoints'] = true;
        $this->supported['current_id'] = true;
        $this->supported['limit_queries'] = true;
        $this->supported['LOBs'] = true;
        $this->supported['replace'] = 'emulated';
        $this->supported['sub_selects'] = true;
        $this->supported['auto_increment'] = 'emulated';
        $this->supported['primary_key'] = true;
        $this->supported['result_introspection'] = true;
        $this->supported['prepared_statements'] = true;
        $this->supported['identifier_quoting'] = true;
        $this->supported['pattern_escaping'] = true;
        $this->supported['new_link'] = true;

        $this->options['multi_query'] = false;
    }

Member Function Documentation

_affectedRows()

MDB2_Driver_pgsql::_affectedRows	(		$connection,
			$result = null
	)

Returns the number of rows affected.

Parameters

resource	$result
resource	$connection

Returns

mixed MDB2 Error Object or the number of rows affected private

Definition at line 650 of file pgsql.php.

References MDB2_Driver_Common\$connection, $result, MDB2_Driver_Common\getConnection(), and PEAR\isError().

Referenced by standaloneQuery().

    {
        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }
        return @pg_affected_rows($result);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

_doConnect()

MDB2_Driver_pgsql::_doConnect	(		$database_name,
			$persistent = false
	)

Does the grunt work of connecting to the database.

Returns

mixed connection resource on success, MDB2 Error Object on failure protected

Definition at line 360 of file pgsql.php.

References MDB2_Driver_Common\$connection, MDB2_Driver_Common\$database_name, $params, GuzzleHttp\Psr7\$protocol, $result, array, PEAR\isError(), MDB2_ERROR_CONNECT_FAILED, MDB2_Driver_Common\raiseError(), and setCharset().

Referenced by connect(), and standaloneQuery().

    {
        if ($database_name == '') {
            $database_name = 'template1';
        }

        $protocol = $this->dsn['protocol'] ? $this->dsn['protocol'] : 'tcp';

        $params = array('');
        if ($protocol == 'tcp') {
            if ($this->dsn['hostspec']) {
                $params[0].= 'host=' . $this->dsn['hostspec'];
            }
            if ($this->dsn['port']) {
                $params[0].= ' port=' . $this->dsn['port'];
            }
        } elseif ($protocol == 'unix') {
            // Allow for pg socket in non-standard locations.
            if ($this->dsn['socket']) {
                $params[0].= 'host=' . $this->dsn['socket'];
            }
            if ($this->dsn['port']) {
                $params[0].= ' port=' . $this->dsn['port'];
            }
        }
        if ($database_name) {
            $params[0].= ' dbname=\'' . addslashes($database_name) . '\'';
        }
        if ($this->dsn['username']) {
            $params[0].= ' user=\'' . addslashes($this->dsn['username']) . '\'';
        }
        if ($this->dsn['password']) {
            $params[0].= ' password=\'' . addslashes($this->dsn['password']) . '\'';
        }
        if (!empty($this->dsn['options'])) {
            $params[0].= ' options=' . $this->dsn['options'];
        }
        if (!empty($this->dsn['tty'])) {
            $params[0].= ' tty=' . $this->dsn['tty'];
        }
        if (!empty($this->dsn['connect_timeout'])) {
            $params[0].= ' connect_timeout=' . $this->dsn['connect_timeout'];
        }
        if (!empty($this->dsn['sslmode'])) {
            $params[0].= ' sslmode=' . $this->dsn['sslmode'];
        }
        if (!empty($this->dsn['service'])) {
            $params[0].= ' service=' . $this->dsn['service'];
        }

        if (!empty($this->dsn['new_link'])
            && ($this->dsn['new_link'] == 'true' || $this->dsn['new_link'] === true))
        {
            if (version_compare(phpversion(), '4.3.0', '>=')) {
                $params[] = PGSQL_CONNECT_FORCE_NEW;
            }
        }

        $connect_function = $persistent ? 'pg_pconnect' : 'pg_connect';

        $connection = @call_user_func_array($connect_function, $params);
        if (!$connection) {
            return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,
                'unable to establish a connection', __FUNCTION__);
        }

       if (empty($this->dsn['disable_iso_date'])) {
            if (!@pg_query($connection, "SET SESSION DATESTYLE = 'ISO'")) {
                return $this->raiseError(null, null, null,
                    'Unable to set date style to iso', __FUNCTION__);
            }
       }

        if (!empty($this->dsn['charset'])) {
            $result = $this->setCharset($this->dsn['charset'], $connection);
            if (PEAR::isError($result)) {
                return $result;
            }
        }

        return $connection;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

_doQuery()

& MDB2_Driver_pgsql::_doQuery	(		$query,
			$is_manip = false,
			$connection = null,
			$database_name = null
	)

Execute a query.

Parameters

string	$query	query
boolean	$is_manip	if the query is a manipulation query
resource	$connection
string	$database_name

Returns

result or error object protected

Definition at line 599 of file pgsql.php.

References MDB2_Driver_Common\$connection, $function, $query, $result, array, MDB2_Driver_Common\debug(), MDB2_Driver_Common\getConnection(), PEAR\isError(), and MDB2_Driver_Common\raiseError().

Referenced by beginTransaction(), commit(), prepare(), rollback(), setTransactionIsolation(), and standaloneQuery().

    {
        $this->last_query = $query;
        $result = $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'pre'));
        if ($result) {
            if (PEAR::isError($result)) {
                return $result;
            }
            $query = $result;
        }
        if ($this->options['disable_query']) {
            $result = $is_manip ? 0 : null;
            return $result;
        }

        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }

        $function = $this->options['multi_query'] ? 'pg_send_query' : 'pg_query';
        $result = @$function($connection, $query);
        if (!$result) {
            $err =& $this->raiseError(null, null, null,
                'Could not execute statement', __FUNCTION__);
            return $err;
        } elseif ($this->options['multi_query']) {
            if (!($result = @pg_get_result($connection))) {
                $err =& $this->raiseError(null, null, null,
                        'Could not get the first result from a multi query', __FUNCTION__);
                return $err;
            }
        }

        $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'post', 'result' => $result));
        return $result;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

_modifyManipQuery()

MDB2_Driver_pgsql::_modifyManipQuery	(		$query,
			$limit
	)

Changes a manip query string for various DBMS specific reasons.

Parameters

string	$query	query to modify
integer	$limit	limit the number of rows

Returns

string modified query protected

Definition at line 703 of file pgsql.php.

References $from, MDB2_Driver_Common\$limit, and $query.

Referenced by _modifyQuery().

    {
        $pos = strpos(strtolower($query), 'where');
        $where = $pos ? substr($query, $pos) : '';

        $manip_clause = '(\bDELETE\b\s+(?:\*\s+)?\bFROM\b|\bUPDATE\b)';
        $from_clause  = '([\w\.]+)';
        $where_clause = '(?:(.*)\bWHERE\b\s+(.*))|(.*)';
        $pattern = '/^'. $manip_clause . '\s+' . $from_clause .'(?:\s)*(?:'. $where_clause .')?$/i';
        $matches = preg_match($pattern, $query, $match);
        if ($matches) {
            $manip = $match[1];
            $from  = $match[2];
            $what  = (count($matches) == 6) ? $match[5] : $match[3];
            return $manip.' '.$from.' '.$what.' WHERE ctid=(SELECT ctid FROM '.$from.' '.$where.' LIMIT '.$limit.')';
        }
        //return error?
        return $query;
    }

Here is the caller graph for this function:

_modifyQuery()

MDB2_Driver_pgsql::_modifyQuery	(		$query,
			$is_manip,
			$limit,
			$offset
	)

Changes a query string for various DBMS specific reasons.

Parameters

string	$query	query to modify
boolean	$is_manip	if it is a DML query
integer	$limit	limit the number of rows
integer	$offset	start reading from given offset

Returns

string modified query protected

Definition at line 674 of file pgsql.php.

References MDB2_Driver_Common\$limit, $query, and _modifyManipQuery().

Referenced by prepare(), and standaloneQuery().

    {
        if ($limit > 0
            && !preg_match('/LIMIT\s*\d(?:\s*(?:,|OFFSET)\s*\d+)?(?:[^\)]*)?$/i', $query)
        ) {
            $query = rtrim($query);
            if (substr($query, -1) == ';') {
                $query = substr($query, 0, -1);
            }
            if ($is_manip) {
                $query = $this->_modifyManipQuery($query, $limit);
            } else {
                $query.= " LIMIT $limit OFFSET $offset";
            }
        }
        return $query;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

beginTransaction()

MDB2_Driver_pgsql::beginTransaction

(

$savepoint = null

)

Start a transaction or set a savepoint.

Parameters

string

name of a savepoint to set

Returns

mixed MDB2_OK on success, a MDB2 error on failure

public

Definition at line 223 of file pgsql.php.

References $query, $result, _doQuery(), array, MDB2_Driver_Common\debug(), PEAR\isError(), MDB2_ERROR_INVALID, MDB2_OK, and MDB2_Driver_Common\raiseError().

    {
        $this->debug('Starting transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        if (!is_null($savepoint)) {
            if (!$this->in_transaction) {
                return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                    'savepoint cannot be released when changes are auto committed', __FUNCTION__);
            }
            $query = 'SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        } elseif ($this->in_transaction) {
            return MDB2_OK;  //nothing to do
        }
        if (!$this->destructor_registered && $this->opened_persistent) {
            $this->destructor_registered = true;
            register_shutdown_function('MDB2_closeOpenTransactions');
        }
        $result =& $this->_doQuery('BEGIN', true);
        if (PEAR::isError($result)) {
            return $result;
        }
        $this->in_transaction = true;
        return MDB2_OK;
    }

Here is the call graph for this function:

commit()

MDB2_Driver_pgsql::commit

(

$savepoint = null

)

Commit the database changes done during a transaction that is in progress or release a savepoint.

This function may only be called when auto-committing is disabled, otherwise it will fail. Therefore, a new transaction is implicitly started after committing the pending changes.

Parameters

string

name of a savepoint to release

Returns

mixed MDB2_OK on success, a MDB2 error on failure

public

Definition at line 262 of file pgsql.php.

References $query, $result, _doQuery(), array, MDB2_Driver_Common\debug(), PEAR\isError(), MDB2_ERROR_INVALID, MDB2_OK, and MDB2_Driver_Common\raiseError().

    {
        $this->debug('Committing transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        if (!$this->in_transaction) {
            return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                'commit/release savepoint cannot be done changes are auto committed', __FUNCTION__);
        }
        if (!is_null($savepoint)) {
            $query = 'RELEASE SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        }

        $result =& $this->_doQuery('COMMIT', true);
        if (PEAR::isError($result)) {
            return $result;
        }
        $this->in_transaction = false;
        return MDB2_OK;
    }

Here is the call graph for this function:

connect()

MDB2_Driver_pgsql::connect

(

)

Connect to the database.

Returns

true on success, MDB2 Error Object on failure public

Definition at line 452 of file pgsql.php.

References MDB2_Driver_Common\$connection, MDB2_Driver_Common\$database_name, MDB2_Driver_Common\$dsn, MDB2_Driver_Common\$phptype, _doConnect(), disconnect(), PEAR\isError(), PEAR\loadExtension(), MDB2_ERROR_NOT_FOUND, MDB2_OK, and MDB2_Driver_Common\raiseError().

    {
        if (is_resource($this->connection)) {
            if (count(array_diff($this->connected_dsn, $this->dsn)) == 0
                && $this->connected_database_name == $this->database_name
                && ($this->opened_persistent == $this->options['persistent'])
            ) {
                return MDB2_OK;
            }
            $this->disconnect(false);
        }

        if (!PEAR::loadExtension($this->phptype)) {
            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,
                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);
        }

        if ($this->database_name) {
            $connection = $this->_doConnect($this->database_name, $this->options['persistent']);
            if (PEAR::isError($connection)) {
                return $connection;
            }
            $this->connection = $connection;
            $this->connected_dsn = $this->dsn;
            $this->connected_database_name = $this->database_name;
            $this->opened_persistent = $this->options['persistent'];
            $this->dbsyntax = $this->dsn['dbsyntax'] ? $this->dsn['dbsyntax'] : $this->phptype;
        }
        return MDB2_OK;
    }

Here is the call graph for this function:

currID()

MDB2_Driver_pgsql::currID

(

$seq_name

)

Returns the current id of a sequence.

Parameters

string

$seq_name

name of the sequence

Returns

mixed MDB2 Error Object or id public

Definition at line 1038 of file pgsql.php.

References getSequenceName(), MDB2_Driver_Common\queryOne(), and MDB2_Driver_Common\quoteIdentifier().

    {
        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);
        return $this->queryOne("SELECT last_value FROM $sequence_name", 'integer');
    }

Here is the call graph for this function:

disconnect()

MDB2_Driver_pgsql::disconnect

(

$force = true

)

Log out and disconnect from the database.

Parameters

boolean

$force

if the disconnect should be forced even if the connection is opened persistently

Returns

mixed true on success, false if not connected and error object on error public

Definition at line 523 of file pgsql.php.

References MDB2_Driver_Common\$connected_database_name, MDB2_Driver_Common\$connected_dsn, MDB2_Driver_Common\$database_name, MDB2_Driver_Common\$dsn, MDB2_Driver_Common\$opened_persistent, and rollback().

Referenced by connect().

    {
        if (is_resource($this->connection)) {
            if ($this->in_transaction) {
                $dsn = $this->dsn;
                $database_name = $this->database_name;
                $persistent = $this->options['persistent'];
                $this->dsn = $this->connected_dsn;
                $this->database_name = $this->connected_database_name;
                $this->options['persistent'] = $this->opened_persistent;
                $this->rollback();
                $this->dsn = $dsn;
                $this->database_name = $database_name;
                $this->options['persistent'] = $persistent;
            }

            if (!$this->opened_persistent || $force) {
                @pg_close($this->connection);
            }
        }
        return parent::disconnect($force);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

errorInfo()

MDB2_Driver_pgsql::errorInfo

(

$error = null

)

This method is used to collect information about an error.

Parameters

integer

$error

Returns

array public

Definition at line 107 of file pgsql.php.

References $code, $error, array, MDB2_ERROR, MDB2_ERROR_ACCESS_VIOLATION, MDB2_ERROR_ALREADY_EXISTS, MDB2_ERROR_CONNECT_FAILED, MDB2_ERROR_CONSTRAINT, MDB2_ERROR_CONSTRAINT_NOT_NULL, MDB2_ERROR_DIVZERO, MDB2_ERROR_INVALID, MDB2_ERROR_INVALID_NUMBER, MDB2_ERROR_NOSUCHFIELD, MDB2_ERROR_NOSUCHTABLE, MDB2_ERROR_NOT_FOUND, MDB2_ERROR_SYNTAX, and MDB2_ERROR_VALUE_COUNT_ON_ROW.

    {
        // Fall back to MDB2_ERROR if there was no mapping.
        $error_code = MDB2_ERROR;

        $native_msg = '';
        if (is_resource($error)) {
            $native_msg = @pg_result_error($error);
        } elseif ($this->connection) {
            $native_msg = @pg_last_error($this->connection);
            if (!$native_msg && @pg_connection_status($this->connection) === PGSQL_CONNECTION_BAD) {
                $native_msg = 'Database connection has been lost.';
                $error_code = MDB2_ERROR_CONNECT_FAILED;
            }
        }

        static $error_regexps;
        if (empty($error_regexps)) {
            $error_regexps = array(
                '/column .* (of relation .*)?does not exist/i'
                    => MDB2_ERROR_NOSUCHFIELD,
                '/(relation|sequence|table).*does not exist|class .* not found/i'
                    => MDB2_ERROR_NOSUCHTABLE,
                '/index .* does not exist/'
                    => MDB2_ERROR_NOT_FOUND,
                '/relation .* already exists/i'
                    => MDB2_ERROR_ALREADY_EXISTS,
                '/(divide|division) by zero$/i'
                    => MDB2_ERROR_DIVZERO,
                '/pg_atoi: error in .*: can\'t parse /i'
                    => MDB2_ERROR_INVALID_NUMBER,
                '/invalid input syntax for( type)? (integer|numeric)/i'
                    => MDB2_ERROR_INVALID_NUMBER,
                '/value .* is out of range for type \w*int/i'
                    => MDB2_ERROR_INVALID_NUMBER,
                '/integer out of range/i'
                    => MDB2_ERROR_INVALID_NUMBER,
                '/value too long for type character/i'
                    => MDB2_ERROR_INVALID,
                '/attribute .* not found|relation .* does not have attribute/i'
                    => MDB2_ERROR_NOSUCHFIELD,
                '/column .* specified in USING clause does not exist in (left|right) table/i'
                    => MDB2_ERROR_NOSUCHFIELD,
                '/parser: parse error at or near/i'
                    => MDB2_ERROR_SYNTAX,
                '/syntax error at/'
                    => MDB2_ERROR_SYNTAX,
                '/column reference .* is ambiguous/i'
                    => MDB2_ERROR_SYNTAX,
                '/permission denied/'
                    => MDB2_ERROR_ACCESS_VIOLATION,
                '/violates not-null constraint/'
                    => MDB2_ERROR_CONSTRAINT_NOT_NULL,
                '/violates [\w ]+ constraint/'
                    => MDB2_ERROR_CONSTRAINT,
                '/referential integrity violation/'
                    => MDB2_ERROR_CONSTRAINT,
                '/more expressions than target columns/i'
                    => MDB2_ERROR_VALUE_COUNT_ON_ROW,
            );
        }
        if (is_numeric($error) && $error < 0) {
            $error_code = $error;
        } else {
            foreach ($error_regexps as $regexp => $code) {
                if (preg_match($regexp, $native_msg)) {
                    $error_code = $code;
                    break;
                }
            }
        }
        return array($error_code, null, $native_msg);
    }

escape()

MDB2_Driver_pgsql::escape	(		$text,
			$escape_wildcards = false
	)

Quotes a string so it can be safely used in a query.

It will quote the text so it can safely be used within a query.

Parameters

string	the input string to quote
bool	escape wildcards

Returns

string quoted string

public

Definition at line 195 of file pgsql.php.

References MDB2_Driver_Common\$connection, $text, MDB2_Driver_Common\escapePattern(), MDB2_Driver_Common\getConnection(), and PEAR\isError().

    {
        if ($escape_wildcards) {
            $text = $this->escapePattern($text);
        }
        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }
        if (version_compare(PHP_VERSION, '5.2.0RC5', '>=')) {
            $text = @pg_escape_string($connection, $text);
        } else {
            $text = @pg_escape_string($text);
        }
        return $text;
    }

Here is the call graph for this function:

getSequenceName()

MDB2_Driver_pgsql::getSequenceName

(

$sqn

)

adds sequence name formatting to a sequence name

Parameters

string

name of the sequence

Returns

string formatted sequence name

public

Definition at line 942 of file pgsql.php.

References $query, $table, PEAR\isError(), MDB2_Driver_Common\queryOne(), and MDB2_Driver_Common\quote().

Referenced by currID(), lastInsertID(), and nextID().

    {
        list($table, $field) = explode('_', $sqn);
        $query = "SELECT substring((SELECT substring(pg_get_expr(d.adbin, d.adrelid) for 128)
                            FROM pg_attrdef d
                           WHERE d.adrelid = a.attrelid
                             AND d.adnum = a.attnum
                             AND a.atthasdef
                         ) FROM 'nextval[^\']*\'([^\']*)')
                    FROM pg_attribute a
                LEFT JOIN pg_class c ON c.oid = a.attrelid
                LEFT JOIN pg_attrdef d ON d.adrelid = a.attrelid AND d.adnum = a.attnum AND a.atthasdef
                   WHERE (c.relname = ".$this->quote($sqn, 'text');
        if (!empty($field)) {
            $query .= " OR (c.relname = ".$this->quote($table, 'text')." AND a.attname = ".$this->quote($field, 'text').")";
        }
        $query .= "      )
                     AND NOT a.attisdropped
                     AND a.attnum > 0
                     AND pg_get_expr(d.adbin, d.adrelid) LIKE 'nextval%'
                ORDER BY a.attnum";
        $seqname = $this->queryOne($query);
        if (!PEAR::isError($seqname) && !empty($seqname) && is_string($seqname)) {
            return $seqname;
        }

        return sprintf($this->options['seqname_format'],
            preg_replace('/[^\w\$.]/i', '_', $sqn));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getServerVersion()

MDB2_Driver_pgsql::getServerVersion

(

$native = false

)

return version information about the server

Parameters

bool

$native

determines if the raw version string should be returned

Returns

mixed array/string with version information or MDB2 error object public

Definition at line 733 of file pgsql.php.

References MDB2_Driver_Common\$connected_server_info, $query, array, PEAR\isError(), and MDB2_Driver_Common\queryOne().

    {
        $query = 'SHOW SERVER_VERSION';
        if ($this->connected_server_info) {
            $server_info = $this->connected_server_info;
        } else {
            $server_info = $this->queryOne($query, 'text');
            if (PEAR::isError($server_info)) {
                return $server_info;
            }
        }
        // cache server_info
        $this->connected_server_info = $server_info;
        if (!$native && !PEAR::isError($server_info)) {
            $tmp = explode('.', $server_info, 3);
            if (empty($tmp[2])
                && isset($tmp[1])
                && preg_match('/(\d+)(.*)/', $tmp[1], $tmp2)
            ) {
                $server_info = array(
                    'major' => $tmp[0],
                    'minor' => $tmp2[1],
                    'patch' => null,
                    'extra' => $tmp2[2],
                    'native' => $server_info,
                );
            } else {
                $server_info = array(
                    'major' => isset($tmp[0]) ? $tmp[0] : null,
                    'minor' => isset($tmp[1]) ? $tmp[1] : null,
                    'patch' => isset($tmp[2]) ? $tmp[2] : null,
                    'extra' => null,
                    'native' => $server_info,
                );
            }
        }
        return $server_info;
    }

Here is the call graph for this function:

lastInsertID()

MDB2_Driver_pgsql::lastInsertID	(		$table = null,
			$field = null
	)

Returns the autoincrement ID if supported or $id or fetches the current ID in a sequence called: $table.

(empty($field) ? '' : '_'.$field)

Parameters

string	$table	name of the table into which a new row was inserted
string	$field	name of the field into which a new row was inserted

Returns

mixed MDB2 Error Object or id public

Definition at line 1018 of file pgsql.php.

References $table, getSequenceName(), and MDB2_Driver_Common\queryOne().

    {
        if (empty($table) && empty($field)) {
            return $this->queryOne('SELECT lastval()', 'integer');
        }
        $seq = $table.(empty($field) ? '' : '_'.$field);
        $sequence_name = $this->getSequenceName($seq);
        return $this->queryOne("SELECT currval('$sequence_name')", 'integer');
    }

Here is the call graph for this function:

nextID()

MDB2_Driver_pgsql::nextID	(		$seq_name,
			$ondemand = true
	)

Returns the next free id of a sequence.

Parameters

string	$seq_name	name of the sequence
boolean	$ondemand	when true the sequence is automatic created, if it not exists

Returns

mixed MDB2 Error Object or id public

Definition at line 985 of file pgsql.php.

References $query, $result, PEAR\expectError(), getSequenceName(), PEAR\isError(), MDB2_Driver_Common\loadModule(), MDB2_ERROR_NOSUCHTABLE, PEAR\popExpect(), MDB2_Driver_Common\queryOne(), MDB2_Driver_Common\quoteIdentifier(), and MDB2_Driver_Common\raiseError().

    {
        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);
        $query = "SELECT NEXTVAL('$sequence_name')";
        $this->expectError(MDB2_ERROR_NOSUCHTABLE);
        $result = $this->queryOne($query, 'integer');
        $this->popExpect();
        if (PEAR::isError($result)) {
            if ($ondemand && $result->getCode() == MDB2_ERROR_NOSUCHTABLE) {
                $this->loadModule('Manager', null, true);
                $result = $this->manager->createSequence($seq_name);
                if (PEAR::isError($result)) {
                    return $this->raiseError($result, null, null,
                        'on demand sequence could not be created', __FUNCTION__);
                }
                return $this->nextId($seq_name, false);
            }
        }
        return $result;
    }

Here is the call graph for this function:

prepare()

& MDB2_Driver_pgsql::prepare	(		$query,
			$types = null,
			$result_types = null,
			$lobs = array()
	)

Prepares a query for multiple execution with execute().

With some database backends, this is emulated. prepare() requires a generic query as string like 'INSERT INTO numbers VALUES(?,?)' or 'INSERT INTO numbers VALUES(:foo,:bar)'. The ? and :[a-zA-Z] and are placeholders which can be set using bindParam() and the query can be send off using the execute() method.

Parameters

string	$query	the query to prepare
mixed	$types	array that contains the types of the placeholders
mixed	$result_types	array that contains the types of the columns in the result set or MDB2_PREPARE_RESULT, if set to MDB2_PREPARE_MANIP the query is handled as a manipulation query
mixed	$lobs	key (field) value (parameter) pair for all lob placeholders

Returns

mixed resource handle for the prepared query on success, a MDB2 error on failure public

See also

bindParam, execute

Definition at line 795 of file pgsql.php.

References MDB2_Driver_Common\$connection, $key, MDB2_Driver_Common\$limit, $name, MDB2_Driver_Common\$offset, $query, $result, _doQuery(), _modifyQuery(), MDB2_Driver_Common\_skipDelimitedStrings(), array, MDB2_Driver_Common\debug(), MDB2_Driver_Common\getConnection(), PEAR\isError(), MDB2_Driver_Common\loadModule(), MDB2_ERROR_SYNTAX, MDB2_PREPARE_MANIP, MDB2_Driver_Common\raiseError(), and time.

    {
        if ($this->options['emulate_prepared']) {
            $obj =& parent::prepare($query, $types, $result_types, $lobs);
            return $obj;
        }
        $is_manip = ($result_types === MDB2_PREPARE_MANIP);
        $offset = $this->offset;
        $limit = $this->limit;
        $this->offset = $this->limit = 0;
        $result = $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'pre'));
        if ($result) {
            if (PEAR::isError($result)) {
                return $result;
            }
            $query = $result;
        }
        $pgtypes = function_exists('pg_prepare') ? false : array();
        if ($pgtypes !== false && !empty($types)) {
            $this->loadModule('Datatype', null, true);
        }
        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);
        $placeholder_type_guess = $placeholder_type = null;
        $question = '?';
        $colon = ':';
        $positions = array();
        $position = $parameter = 0;
        while ($position < strlen($query)) {
            $q_position = strpos($query, $question, $position);
            $c_position = strpos($query, $colon, $position);
            if ($q_position && $c_position) {
                $p_position = min($q_position, $c_position);
            } elseif ($q_position) {
                $p_position = $q_position;
            } elseif ($c_position) {
                $p_position = $c_position;
            } else {
                break;
            }
            if (is_null($placeholder_type)) {
                $placeholder_type_guess = $query[$p_position];
            }
            
            $new_pos = $this->_skipDelimitedStrings($query, $position, $p_position);
            if (PEAR::isError($new_pos)) {
                return $new_pos;
            }
            if ($new_pos != $position) {
                $position = $new_pos;
                continue; //evaluate again starting from the new position
            }

            if ($query[$position] == $placeholder_type_guess) {
                if (is_null($placeholder_type)) {
                    $placeholder_type = $query[$p_position];
                    $question = $colon = $placeholder_type;
                    if (!empty($types) && is_array($types)) {
                        if ($placeholder_type == ':') {
                        } else {
                            $types = array_values($types);
                        }
                    }
                }
                if ($placeholder_type_guess == '?') {
                    $length = 1;
                    $name = $parameter;
                } else {
                    $name = preg_replace('/^.{'.($position+1).'}([a-z0-9_]+).*$/si', '\\1', $query);
                    if ($name === '') {
                        $err =& $this->raiseError(MDB2_ERROR_SYNTAX, null, null,
                            'named parameter with an empty name', __FUNCTION__);
                        return $err;
                    }
                    $length = strlen($name) + 1;
                }
                if ($pgtypes !== false) {
                    if (is_array($types) && array_key_exists($name, $types)) {
                        $pgtypes[] = $this->datatype->mapPrepareDatatype($types[$name]);
                    } elseif (is_array($types) && array_key_exists($parameter, $types)) {
                        $pgtypes[] = $this->datatype->mapPrepareDatatype($types[$parameter]);
                    } else {
                        $pgtypes[] = 'text';
                    }
                }
                if (($key_parameter = array_search($name, $positions))) {
                    $next_parameter = 1;
                    foreach ($positions as $key => $value) {
                        if ($key_parameter == $key) {
                            break;
                        }
                        ++$next_parameter;
                    }
                } else {
                    ++$parameter;
                    $next_parameter = $parameter;
                    $positions[] = $name;
                }
                $query = substr_replace($query, '$'.$parameter, $position, $length);
                $position = $p_position + strlen($parameter);
            } else {
                $position = $p_position;
            }
        }
        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $statement_name = sprintf($this->options['statement_format'], $this->phptype, md5(time() + rand()));
        $statement_name = strtolower($statement_name);
        if ($pgtypes === false) {
            $result = @pg_prepare($connection, $statement_name, $query);
            if (!$result) {
                $err =& $this->raiseError(null, null, null,
                    'Unable to create prepared statement handle', __FUNCTION__);
                return $err;
            }
        } else {
            $types_string = '';
            if ($pgtypes) {
                $types_string = ' ('.implode(', ', $pgtypes).') ';
            }
            $query = 'PREPARE '.$statement_name.$types_string.' AS '.$query;
            $statement =& $this->_doQuery($query, true, $connection);
            if (PEAR::isError($statement)) {
                return $statement;
            }
        }

        $class_name = 'MDB2_Statement_'.$this->phptype;
        $obj = new $class_name($this, $statement_name, $positions, $query, $types, $result_types, $is_manip, $limit, $offset);
        $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'post', 'result' => $obj));
        return $obj;
    }

Here is the call graph for this function:

rollback()

MDB2_Driver_pgsql::rollback

(

$savepoint = null

)

Cancel any database changes done during a transaction or since a specific savepoint that is in progress.

This function may only be called when auto-committing is disabled, otherwise it will fail. Therefore, a new transaction is implicitly started after canceling the pending changes.

Parameters

string

name of a savepoint to rollback to

Returns

mixed MDB2_OK on success, a MDB2 error on failure

public

Definition at line 296 of file pgsql.php.

References $query, $result, _doQuery(), array, MDB2_Driver_Common\debug(), PEAR\isError(), MDB2_ERROR_INVALID, MDB2_OK, and MDB2_Driver_Common\raiseError().

Referenced by disconnect().

    {
        $this->debug('Rolling back transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        if (!$this->in_transaction) {
            return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                'rollback cannot be done changes are auto committed', __FUNCTION__);
        }
        if (!is_null($savepoint)) {
            $query = 'ROLLBACK TO SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        }

        $query = 'ROLLBACK';
        $result =& $this->_doQuery($query, true);
        if (PEAR::isError($result)) {
            return $result;
        }
        $this->in_transaction = false;
        return MDB2_OK;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setCharset()

MDB2_Driver_pgsql::setCharset	(		$charset,
			$connection = null
	)

Set the charset on the current connection.

Parameters

string	charset
resource	connection handle

Returns

true on success, MDB2 Error Object on failure

Definition at line 494 of file pgsql.php.

References MDB2_Driver_Common\$connection, $result, MDB2_Driver_Common\getConnection(), PEAR\isError(), MDB2_OK, and MDB2_Driver_Common\raiseError().

Referenced by _doConnect().

    {
        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }

        $result = @pg_set_client_encoding($connection, $charset);
        if ($result == -1) {
            return $this->raiseError(null, null, null,
                'Unable to set client charset: '.$charset, __FUNCTION__);
        }
        return MDB2_OK;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setTransactionIsolation()

MDB2_Driver_pgsql::setTransactionIsolation

(

$isolation

)

Set the transacton isolation level.

Parameters

string

standard isolation level READ UNCOMMITTED (allows dirty reads) READ COMMITTED (prevents dirty reads) REPEATABLE READ (prevents nonrepeatable reads) SERIALIZABLE (prevents phantom reads)

Returns

mixed MDB2_OK on success, a MDB2 error on failure

public

Since

2.1.1

Definition at line 333 of file pgsql.php.

References $query, _doQuery(), array, MDB2_Driver_Common\debug(), MDB2_ERROR_UNSUPPORTED, and MDB2_Driver_Common\raiseError().

    {
        $this->debug('Setting transaction isolation level', __FUNCTION__, array('is_manip' => true));
        switch ($isolation) {
        case 'READ UNCOMMITTED':
        case 'READ COMMITTED':
        case 'REPEATABLE READ':
        case 'SERIALIZABLE':
            break;
        default:
            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'isolation level is not supported: '.$isolation, __FUNCTION__);
        }

        $query = "SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL $isolation";
        return $this->_doQuery($query, true);
    }

Here is the call graph for this function:

standaloneQuery()

& MDB2_Driver_pgsql::standaloneQuery	(		$query,
			$types = null,
			$is_manip = false
	)

execute a query as DBA

Parameters

string	$query	the SQL query
mixed	$types	array that contains the types of the columns in the result set
boolean	$is_manip	if the query is a manipulation query

Returns

mixed MDB2_OK on success, a MDB2 error on failure public

Definition at line 559 of file pgsql.php.

References MDB2_Driver_Common\$connection, MDB2_Driver_Common\$limit, MDB2_Driver_Common\$offset, $query, $result, _affectedRows(), _doConnect(), _doQuery(), _modifyQuery(), MDB2_Driver_Common\_wrapResult(), PEAR\isError(), MDB2_ERROR_CONNECT_FAILED, and MDB2_Driver_Common\raiseError().

    {
        $connection = $this->_doConnect('template1', false);
        if (PEAR::isError($connection)) {
            $err =& $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,
                'Cannot connect to template1', __FUNCTION__);
            return $err;
        }

        $offset = $this->offset;
        $limit = $this->limit;
        $this->offset = $this->limit = 0;
        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);

        $result =& $this->_doQuery($query, $is_manip, $connection, false);
        @pg_close($connection);
        if (PEAR::isError($result)) {
            return $result;
        }

        if ($is_manip) {
            $affected_rows =  $this->_affectedRows($connection, $result);
            return $affected_rows;
        }
        $result =& $this->_wrapResult($result, $types, true, false, $limit, $offset);
        return $result;
    }

Here is the call graph for this function:

Field Documentation

$identifier_quoting

MDB2_Driver_pgsql::$identifier_quoting = array('start' => '"', 'end' => '"', 'escape' => '"')

Definition at line 60 of file pgsql.php.

$string_quoting

MDB2_Driver_pgsql::$string_quoting = array('start' => "'", 'end' => "'", 'escape' => "'", 'escape_pattern' => '\\')

Definition at line 58 of file pgsql.php.

---

The documentation for this class was generated from the following file:

• Services/Database/lib/PEAR/MDB2/Driver/pgsql.php