2005-07-04 01:07:14 +00:00
< ? php
2005-08-21 06:49:02 +00:00
/* SVN FILE: $Id$ */
2005-06-12 20:50:12 +00:00
/**
2005-08-21 06:49:02 +00:00
* PostgreSQL layer for DBO .
*
* Long description for file
*
* PHP versions 4 and 5
*
* CakePHP : Rapid Development Framework < http :// www . cakephp . org />
2005-12-23 21:57:26 +00:00
* Copyright ( c ) 2005 , Cake Software Foundation , Inc .
* 1785 E . Sahara Avenue , Suite 490 - 204
* Las Vegas , Nevada 89104
2005-08-21 06:49:02 +00:00
*
2005-12-23 21:57:26 +00:00
* Licensed under The MIT License
* Redistributions of files must retain the above copyright notice .
2005-08-21 06:49:02 +00:00
*
* @ filesource
2005-12-23 21:57:26 +00:00
* @ copyright Copyright ( c ) 2005 , Cake Software Foundation , Inc .
* @ link http :// www . cakefoundation . org / projects / info / cakephp CakePHP Project
2005-08-21 06:49:02 +00:00
* @ package cake
2005-10-09 01:56:21 +00:00
* @ subpackage cake . cake . libs . model . dbo
2005-08-21 06:49:02 +00:00
* @ since CakePHP v 0.9 . 1.114
* @ version $Revision $
* @ modifiedby $LastChangedBy $
* @ lastmodified $Date $
* @ license http :// www . opensource . org / licenses / mit - license . php The MIT License
*/
2005-06-12 20:50:12 +00:00
/**
* Include DBO .
*/
2005-10-03 04:48:00 +00:00
uses ( 'model' . DS . 'dbo' . DS . 'dbo' );
2005-06-12 20:50:12 +00:00
/**
2005-09-07 01:52:45 +00:00
* PostgreSQL layer for DBO .
2005-08-21 06:49:02 +00:00
*
* Long description for class
*
* @ package cake
2005-10-09 01:56:21 +00:00
* @ subpackage cake . cake . libs . model . dbo
2005-08-21 06:49:02 +00:00
* @ since CakePHP v 0.9 . 1.114
*/
2005-06-14 19:57:01 +00:00
class DBO_Postgres extends DBO
{
2005-07-10 05:08:19 +00:00
2005-06-12 20:50:12 +00:00
/**
* Connects to the database using options in the given configuration array .
*
* @ param array $config Configuration array for connecting
* @ return True if successfully connected .
*/
2005-07-10 05:08:19 +00:00
function connect ( $config )
{
if ( $config )
{
$this -> config = $config ;
2005-10-24 09:54:24 +00:00
$this -> _conn = $config [ 'connect' ]( " host= { $config [ 'host' ] } dbname= { $config [ 'database' ] } user= { $config [ 'login' ] } password= { $config [ 'password' ] } " );
2005-07-10 05:08:19 +00:00
}
$this -> connected = $this -> _conn ? true : false ;
if ( $this -> connected )
return true ;
else
2005-08-21 06:49:02 +00:00
{
//die('Could not connect to DB.');
}
2005-07-10 05:08:19 +00:00
}
2005-06-12 20:50:12 +00:00
/**
* Disconnects from database .
*
* @ return boolean True if the database could be disconnected , else false
*/
2005-07-10 05:08:19 +00:00
function disconnect ()
{
return pg_close ( $this -> _conn );
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Executes given SQL statement .
*
* @ param string $sql SQL statement
* @ return resource Result resource identifier
*/
2005-07-10 05:08:19 +00:00
function execute ( $sql )
{
return pg_query ( $this -> _conn , $sql );
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Returns a row from given resultset as an array .
*
* @ return array The fetched row as an array
*/
2005-07-10 05:08:19 +00:00
function fetchRow ()
{
2005-09-07 01:52:45 +00:00
return pg_fetch_array ( $this -> _result );
2005-07-10 05:08:19 +00:00
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Returns an array of tables in the database . If there are no tables , an error is raised and the application exits .
*
* @ return array Array of tablenames in the database
*/
2005-07-10 05:08:19 +00:00
function tablesList ()
{
$sql = " SELECT a.relname AS name
2005-06-12 20:50:12 +00:00
FROM pg_class a , pg_user b
WHERE ( relkind = 'r' ) and relname !~ '^pg_' AND relname !~ '^sql_'
AND relname !~ '^xin[vx][0-9]+' AND b . usesysid = a . relowner
AND NOT ( EXISTS ( SELECT viewname FROM pg_views WHERE viewname = a . relname )); " ;
2005-07-10 05:08:19 +00:00
$result = $this -> all ( $sql );
if ( ! $result )
{
trigger_error ( ERROR_NO_TABLE_LIST , E_USER_ERROR );
exit ;
}
else
{
$tables = array ();
foreach ( $result as $item ) $tables [] = $item [ 'name' ];
return $tables ;
}
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Returns an array of the fields in given table name .
*
2005-09-18 13:25:20 +00:00
* @ param string $tableName Name of database table to inspect
2005-09-14 04:11:56 +00:00
* @ return array Fields in table . Keys are name and type
*/
2005-09-18 13:25:20 +00:00
function fields ( $tableName )
2005-07-10 05:08:19 +00:00
{
2005-09-18 13:25:20 +00:00
$sql = " SELECT c.relname, a.attname, t.typname FROM pg_class c, pg_attribute a, pg_type t WHERE c.relname = ' { $tableName } ' AND a.attnum > 0 AND a.attrelid = c.oid AND a.atttypid = t.oid " ;
2005-07-10 05:08:19 +00:00
$fields = false ;
foreach ( $this -> all ( $sql ) as $field ) {
$fields [] = array (
'name' => $field [ 'attname' ],
'type' => $field [ 'typname' ]);
}
return $fields ;
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Returns a quoted and escaped string of $data for use in an SQL statement .
*
* @ param string $data String to be prepared for use in an SQL statement
* @ return string Quoted and escaped
*/
2005-07-10 05:08:19 +00:00
function prepareValue ( $data )
{
2005-09-14 04:11:56 +00:00
return " ' " . pg_escape_string ( $data ) . " ' " ;
2005-07-10 05:08:19 +00:00
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Returns a formatted error message from previous database operation .
*
* @ return string Error message
*/
2005-07-10 05:08:19 +00:00
function lastError ()
{
2005-09-07 01:52:45 +00:00
$last_error = pg_last_error ( $this -> _conn );
2005-07-10 05:08:19 +00:00
return $last_error ? $last_error : null ;
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Returns number of affected rows in previous database operation . If no previous operation exists , this returns false .
*
* @ return int Number of affected rows
*/
2005-07-10 05:08:19 +00:00
function lastAffected ()
{
return $this -> _result ? pg_affected_rows ( $this -> _result ) : false ;
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Returns number of rows in previous resultset . If no previous resultset exists ,
* this returns false .
*
* @ return int Number of rows in resultset
*/
2005-07-10 05:08:19 +00:00
function lastNumRows ()
{
return $this -> _result ? pg_num_rows ( $this -> _result ) : false ;
}
2005-06-12 20:50:12 +00:00
2005-09-14 04:11:56 +00:00
/**
* Returns the ID generated from the previous INSERT operation .
*
* @ param string $table Name of the database table
* @ param string $field Name of the ID database field . Defaults to " id "
* @ return int
*/
2005-07-10 05:08:19 +00:00
function lastInsertId ( $table , $field = 'id' )
{
$sql = " SELECT CURRVAL(' { $table } _ { $field } _seq') AS max " ;
$res = $this -> rawQuery ( $sql );
$data = $this -> fetchRow ( $res );
return $data [ 'max' ];
}
2005-09-14 04:11:56 +00:00
/**
* Returns a limit statement in the correct format for the particular database .
*
* @ param int $limit Limit of results returned
* @ param int $offset Offset from which to start results
* @ return string SQL limit / offset statement
*/
2005-07-10 05:08:19 +00:00
function selectLimit ( $limit , $offset = null )
{
return " LIMIT { $limit } " . ( $offset ? " OFFSET { $offset } " : null );
}
2005-06-14 19:57:01 +00:00
2005-06-12 20:50:12 +00:00
}
2005-05-16 23:14:37 +00:00
?>