Amélioration des gestionnaires de bases: Meilleur commentaire et les fonctions qui nécessitent un resultset peuvent le recevoir en paramètre.

This commit is contained in:
Laurent Destailleur 2005-01-23 01:47:51 +00:00
parent 644e0c7039
commit 830137f270
2 changed files with 857 additions and 838 deletions

View File

@ -1,7 +1,7 @@
<?php
/* Copyright (C) 2001 Fabien Seisen <seisen@linuxfr.org>
* Copyright (C) 2002-2004 Rodolphe Quiedeville <rodolphe@quiedeville.org>
* Copyright (C) 2004 Laurent Destailleur <eldy@users.sourceforge.net>
* Copyright (C) 2004-2005 Laurent Destailleur <eldy@users.sourceforge.net>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
@ -22,312 +22,380 @@
*
*/
/** \file htdocs/lib/mysql.lib.php
\brief Classe permettant de gérér la database de dolibarr.
\author Fabien Seisen
\author Rodolphe Quiedeville.
\author Laurent Destailleur.
\version $Revision$
Ensemble des fonctions permettant de gérer la database de dolibarr.
/** \file htdocs/lib/mysql.lib.php
\brief Fichier de la classe permettant de gérér la database de dolibarr.
\author Fabien Seisen
\author Rodolphe Quiedeville.
\author Laurent Destailleur.
\version $Revision$
*/
/** \class DoliDb
\brief Classe permettant de gérér la database de dolibarr
Ensemble des fonctions permettant de gérer la database de dolibarr
/** \class DoliDb
\brief Classe permettant de gérér la database de dolibarr
*/
class DoliDb
{
var $db, $results, $ok, $connected, $database_selected;
var $db; // Handler de base
var $results; // Resultset de la dernière requete
// Constantes pour code erreurs
var $ERROR_DUPLICATE=1062;
var $ERROR_TABLEEXISTS=1050;
var $connected; // 1 si connecté, 0 sinon
var $database_selected; // 1 si base sélectionné, 0 sinon
var $transaction_opened; // 1 si une transaction est en cours, 0 sinon
/**
\brief Ouverture d'une connection vers le serveur et éventuellement une database.
\param type type de base de données (mysql ou pgsql)
\param host addresse de la base de données
\param user nom de l'utilisateur autorisé
\param pass mot de passe
\param name nom de la database
\return int 1 en cas de succès, 0 sinon
*/
var $ok;
function DoliDb($type = 'mysql', $host = '', $user = '', $pass = '', $name = '')
{
global $conf;
// Constantes pour code erreurs
var $ERROR_DUPLICATE=1062;
var $ERROR_TABLEEXISTS=1050;
if ($host == '')
{
$host = $conf->db->host;
}
if ($user == '')
{
$user = $conf->db->user;
}
/**
\brief Ouverture d'une connection vers le serveur et éventuellement une database.
\param type type de base de données (mysql ou pgsql)
\param host addresse de la base de données
\param user nom de l'utilisateur autorisé
\param pass mot de passe
\param name nom de la database
\return int 1 en cas de succès, 0 sinon
*/
function DoliDb($type = 'mysql', $host = '', $user = '', $pass = '', $name = '')
{
global $conf;
$this->transaction_opened=0;
if ($pass == '')
{
$pass = $conf->db->pass;
}
if ($host == '') $host = $conf->db->host;
if ($user == '') $user = $conf->db->user;
if ($pass == '') $pass = $conf->db->pass;
if ($name == '') $name = $conf->db->name;
if ($name == '')
{
$name = $conf->db->name;
}
//print "Name DB: $host,$user,$pass,$name<br>";
//print "Name DB: $host,$user,$pass,$name<br>";
// Essai connexion serveur
// Essai connexion serveur
$this->db = $this->connect($host, $user, $pass);
$this->db = $this->connect($host, $user, $pass);
if ($this->db)
{
$this->connected = 1;
$this->ok = 1;
}
else
{
$this->connected = 0;
$this->ok = 0;
}
if ($this->db)
{
$this->connected = 1;
$this->ok = 1;
}
else
{
$this->connected = 0;
$this->ok = 0;
}
// Si connexion serveur ok et si connexion base demandée, on essaie connexion base
// Si connexion serveur ok et si connexion base demandée, on essaie connexion base
if ($this->connected && $name)
if ($this->connected && $name)
{
if ($this->select_db($name) == 1)
{
if ($this->select_db($name) == 1)
{
$this->database_selected = 1;
$this->ok = 1;
}
else
{
$this->database_selected = 0;
$this->ok = 0;
}
$this->database_selected = 1;
$this->ok = 1;
}
else
{
// Pas de selection de base demandée, ok ou ko
$this->database_selected = 0;
$this->database_selected = 0;
$this->ok = 0;
}
}
else
{
// Pas de selection de base demandée, ok ou ko
$this->database_selected = 0;
}
return $this->ok;
return $this->ok;
}
/**
\brief Selectionne une database.
\param database nom de la database
\return resource
*/
/**
\brief Selectionne une database.
\param database nom de la database
\return resource
*/
function select_db($database)
function select_db($database)
{
return mysql_select_db($database, $this->db);
return mysql_select_db($database, $this->db);
}
/**
\brief Connection vers le serveur
\param host addresse de la base de données
\param login nom de l'utilisateur autorisé
\param passwd mot de passe
\return resource handler d'accès à la base
*/
/**
\brief Connection vers le serveur
\param host addresse de la base de données
\param login nom de l'utilisateur autoris
\param passwd mot de passe
\return resource handler d'accès à la base
*/
function connect($host, $login, $passwd)
function connect($host, $login, $passwd)
{
$this->db = @mysql_connect($host, $login, $passwd);
//print "Resultat fonction connect: ".$this->db;
return $this->db;
$this->db = @mysql_connect($host, $login, $passwd);
//print "Resultat fonction connect: ".$this->db;
return $this->db;
}
/**
\brief Connexion sur une base de donnée
\param database nom de la database
\return result resultat 1 pour ok, 0 pour non ok
*/
/**
\brief Connexion sur une base de donnée
\param database nom de la database
\return result resultat 1 pour ok, 0 pour non ok
*/
function create_db($database)
{
if (mysql_create_db ($database, $this->db))
{
return 1;
}
else
{
return 0;
}
}
/**
\brief Copie d'une database.
\return resource
*/
function clone()
function create_db($database)
{
$db2 = new DoliDb("", "", "", "", "");
$db2->db = $this->db;
return $db2;
if (mysql_create_db ($database, $this->db))
{
return 1;
}
else
{
return 0;
}
}
/**
\brief Ouverture d'une connection vers une database.
\param host addresse de la base de données
\param login nom de l'utilisateur autorisé
\param passwd mot de passe
\return resource handler d'accès à la base
*/
/**
\brief Copie d'un handler de database.
\return resource
*/
function pconnect($host, $login, $passwd)
function clone()
{
$this->db = mysql_pconnect($host, $login, $passwd);
return $this->db;
$db2 = new DoliDb("", "", "", "", "");
$db2->db = $this->db;
return $db2;
}
/**
\brief Fermeture d'une connection vers une database.
\return resource
*/
/**
\brief Ouverture d'une connection vers une database.
\param host Adresse de la base de données
\param login Nom de l'utilisateur autorisé
\param passwd Mot de passe
\return resource handler d'accès à la base
*/
function close()
{
return mysql_close($this->db);
}
/**
\brief Debut d'une transaction.
\param do
\return string
*/
function begin($do=1)
{
if ($do)
{
return $this->query("BEGIN");
}
else
{
return 1;
}
}
/**
\brief Ecriture d'une transaction.
\param do
\return string
*/
function commit($do=1)
{
if ($do)
{
return $this->query("COMMIT");
}
else
{
return 1;
}
}
/**
\brief Effacement d'une transaction et retour au ancienne valeurs.
\param do
\return string
*/
function rollback($do=1)
{
if ($do)
{
return $this->query("ROLLBACK");
}
else
{
return 1;
}
}
/**
\brief Effectue une requete et renvoi le resultset de réponse de la base
\param query contenu de la query
\param limit
\param offset
\return resource resultset
*/
function query($query, $limit="", $offset="")
function pconnect($host, $login, $passwd)
{
$query = trim($query);
$this->lastquery=$query;
$this->results = mysql_query($query, $this->db);
return $this->results;
$this->db = mysql_pconnect($host, $login, $passwd);
return $this->db;
}
/**
\brief Liste des tables dans une database.
\param database nom de la database
\return resource
*/
/**
\brief Fermeture d'une connection vers une database.
\return resource
*/
function list_tables($database)
{
$this->results = mysql_list_tables($database, $this->db);
return $this->results;
}
/**
\brief Renvoie les données de la requete.
\param nb contenu de la query
\param fieldname nom du champ
\return resource
*/
function result($nb, $fieldname)
function close()
{
return mysql_result($this->results, $nb, $fieldname);
return mysql_close($this->db);
}
/**
\brief Libère le dernier resultset utilisé sur cette connexion.
\return resource
*/
function free()
/**
\brief Debut d'une transaction.
\return int 1 si ouverture transaction ok ou deja ouverte, 0 en cas d'erreur
*/
function begin()
{
return mysql_free_result($this->results);
if (! $this->transaction_opened)
{
$ret=$this->query("BEGIN");
if ($ret) $this->transaction_opened++;
return $ret;
}
else
{
$this->transaction_opened++;
return 1;
}
}
/**
\brief Renvoie la ligne courante (comme un objet) pour le curseur resultset.
\param resultset curseur de la requete voulue
\return resource
*/
/**
\brief Validation d'une transaction
\return int 1 si validation ok ou niveau de transaction non ouverte, 0 en cas d'erreur
*/
function fetch_object($resultset=0)
function commit()
{
if ($this->transaction_opened==1)
{
$ret=$this->query("COMMIT");
if ($ret) $this->transaction_opened=0;
return $ret;
}
else
{
$this->transaction_opened--;
return 1;
}
}
/**
\brief Annulation d'une transaction et retour aux anciennes valeurs
\return int 1 si annulation ok ou transaction non ouverte, 0 en cas d'erreur
*/
function rollback()
{
if ($this->transaction_opened)
{
$ret=$this->query("ROLLBACK");
$this->transaction_opened=0;
return $ret;
}
else
{
return 1;
}
}
/**
\brief Effectue une requete et renvoi le resultset de réponse de la base
\param query Contenu de la query
\return resource Resultset de la reponse
*/
function query($query)
{
$query = trim($query);
$this->lastquery=$query;
$this->results = mysql_query($query, $this->db);
return $this->results;
}
/**
\brief Renvoie les données de la requete.
\param nb Contenu de la query
\param fieldname Nom du champ
\return resource
*/
function result($nb, $fieldname)
{
return mysql_result($this->results, $nb, $fieldname);
}
/**
\brief Renvoie la ligne courante (comme un objet) pour le curseur resultset.
\param resultset Curseur de la requete voulue
\return resource
*/
function fetch_object($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return mysql_fetch_object($resultset);
}
}
/**
\brief défini les limites de la requète.
\param limit
\param offset
\return int limite
*/
/**
\brief Renvoie les données dans un tableau.
\param resultset Curseur de la requete voulue
\return array
*/
function plimit($limit=0,$offset=0)
function fetch_array($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return mysql_fetch_array($resultset);
}
/**
\brief Renvoie les données comme un tableau.
\param resultset Curseur de la requete voulue
\return array
*/
function fetch_row($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return mysql_fetch_row($resultset);
}
/**
\brief Obtient les données d'un colonne et renvoie les données sous forme d'objet.
\param resultset Curseur de la requete voulue
\return array
*/
function fetch_field($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return mysql_fetch_field($resultset);
}
/**
\brief Renvoie le nombre de lignes dans le resultat d'une requete SELECT
\see affected_rows
\param resultset Curseur de la requete voulue
\return int Nombre de lignes
*/
function num_rows($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return mysql_num_rows($resultset);
}
/**
\brief Renvoie le nombre de lignes dans le resultat d'une requete INSERT, DELETE ou UPDATE
\see num_rows
\param resultset Curseur de la requete voulue
\return int Nombre de lignes
*/
function affected_rows($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
// mysql necessite un link de base pour cette fonction contrairement
// a pqsql qui prend un resultset
return mysql_affected_rows($this->db);
}
/**
\brief Renvoie le nombre de champs dans le resultat de la requete.
\param resultset Curseur de la requete voulue
\return int
*/
function num_fields($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return mysql_num_fields($resultset);
}
/**
\brief Libère le dernier resultset utilisé sur cette connexion.
\param resultset Curseur de la requete voulue
\return resource
*/
function free($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return mysql_free_result($resultset);
}
/**
\brief Défini les limites de la requète.
\param limit
\param offset
\return int Limite
*/
function plimit($limit=0,$offset=0)
{
if ($offset > 0)
{
@ -340,154 +408,96 @@ class DoliDb
}
/**
\brief Formatage par la base de données d'un champ de la base au format Timestamp ou Date (YYYY-MM-DD HH:MM:SS)
afin de retourner une donnée toujours au format universel date tms unix.
\param fname
\return date
*/
function pdate($fname)
/**
\brief Formatage par la base de données d'un champ de la base au format Timestamp ou Date (YYYY-MM-DD HH:MM:SS)
afin de retourner une donnée toujours au format universel date tms unix.
\param fname
\return date
*/
function pdate($fname)
{
return "unix_timestamp($fname)";
return "unix_timestamp($fname)";
}
/**
\brief Formatage de la date en fonction des locales.
\param fname
\return date
*/
function idate($fname)
/**
\brief Formatage de la date en fonction des locales.
\param fname
\return date
*/
function idate($fname)
{
return strftime("%Y%m%d%H%M%S",$fname);
return strftime("%Y%m%d%H%M%S",$fname);
}
/**
\brief Renvoie la derniere requete soumise par la methode query()
\return lastquery
*/
/**
\brief Renvoie les données dans un tableau.
\return array
*/
function fetch_array()
function lastquery()
{
return mysql_fetch_array($this->results);
return $this->lastquery;
}
/**
\brief Renvoie les données comme un tableau.
\return array
*/
/**
\brief Renvoie le texte de l'erreur mysql de l'operation precedente.
\return error_text
*/
function fetch_row()
function error()
{
return mysql_fetch_row($this->results);
return mysql_error($this->db);
}
/**
\brief Obtient les données d'un colonne et renvoie les données sous forme d'objet.
\return array
*/
/**
\brief Renvoie la valeur numerique de l'erreur de l'operation precedente.
pour etre exploiter par l'appelant et détecter les erreurs du genre:
echec car doublons, table deja existante...
\return error_num
*/
function fetch_field()
function errno()
{
return mysql_fetch_field($this->results);
// $ERROR_DUPLICATE=1062;
// $ERROR_TABLEEXISTS=1050;
return mysql_errno($this->db);
}
/**
\brief Obtient l'id genéré par le dernier INSERT.
\return id
*/
/**
\brief Renvoie le nombre de lignes dans le
resultat d'une requete SELECT
\see affected_rows
\return int nombre de lignes
*/
function num_rows()
function last_insert_id()
{
return mysql_num_rows($this->results);
return mysql_insert_id($this->db);
}
/**
\brief Renvoie le nombre de lignes dans le
resultat d'une requete INSERT, DELETE ou UPDATE
\see num_rows
\return int nombre de lignes
*/
/**
\brief Retourne le dsn pear
\return dsn
*/
function affected_rows()
function getdsn($db_type,$db_user,$db_pass,$db_host,$dbname)
{
// mysql necessite un link de base pour cette fonction contrairement
// a pqsql qui prend un resultset
return mysql_affected_rows($this->db);
$pear = $db_type.'://'.$db_user.':'.$db_pass.'@'.
$db_host.'/'.$db_name;
return $pear;
}
/**
\brief Liste des tables dans une database.
\param database Nom de la database
\return resource
*/
/**
\brief Renvoie le nombre de champs dans le resultat de la requete.
\return int
*/
function num_fields()
function list_tables($database)
{
return mysql_num_fields($this->results);
$this->results = mysql_list_tables($database, $this->db);
return $this->results;
}
/**
\brief Renvoie la derniere requete soumise par la methode query()
\return lastquery
*/
function lastquery()
{
return $this->lastquery;
}
/**
\brief Renvoie le texte de l'erreur mysql de l'operation precedente.
\return error_text
*/
function error()
{
return mysql_error($this->db);
}
/**
\brief Renvoie la valeur numerique de l'erreur de l'operation precedente.
pour etre exploiter par l'appelant et détecter les erreurs du genre:
echec car doublons, table deja existante...
\return error_num
*/
function errno()
{
// $ERROR_DUPLICATE=1062;
// $ERROR_TABLEEXISTS=1050;
return mysql_errno($this->db);
}
/**
\brief Obtient l'id genéré par le précedent INSERT.
\return id
*/
function last_insert_id()
{
return mysql_insert_id($this->db);
}
/**
\brief Retourne le dsn pear
\return dsn
*/
function getdsn($db_type,$db_user,$db_pass,$db_host,$dbname)
{
$pear = $db_type.'://'.$db_user.':'.$db_pass.'@'.
$db_host.'/'.$db_name;
return $pear;
}
}
?>

View File

@ -25,485 +25,494 @@
*/
/** \file htdocs/lib/pgsql.lib.php
\brief Classe permettant de gérér la database de dolibarr.
\brief Fichier de la classe permettant de gérér la database de dolibarr.
\author Fabien Seisen
\author Rodolphe Quiedeville.
\author Laurent Destailleur.
\author Sébastien Di Cintio
\author Benoit Mortier
\version $Revision$
Ensemble des fonctions permettant de gérer la database de dolibarr.
*/
/** \class DoliDb
\brief Classe permettant de gérér la database de dolibarr
Ensemble des fonctions permettant de gérer la database de dolibarr
*/
class DoliDb
{
var $db, $results, $ok, $connected, $database_selected;
var $db; // Handler de base
var $results; // Resultset de la dernière requete
// Constantes pour code erreurs
var $ERROR_DUPLICATE="23505";
var $ERROR_TABLEEXISTS='42P07';
var $connected; // 1 si connecté, 0 sinon
var $database_selected; // 1 si base sélectionné, 0 sinon
var $transaction_opened; // 1 si une transaction est en cours, 0 sinon
/**
\brief Ouverture d'une connection vers le serveur et une database.
\param type type de base de données (mysql ou pgsql)
\param host addresse de la base de données
\param user nom de l'utilisateur autorisé
\param pass mot de passe
\param name nom de la database
\return int 1 en cas de succès, 0 sinon
*/
var $ok;
function DoliDb($type = 'pgsql', $host = '', $user = '', $pass = '', $name = '')
{
global $conf;
// Constantes pour code erreurs
var $ERROR_DUPLICATE="23505";
var $ERROR_TABLEEXISTS='42P07';
if ($host == '')
{
$host = $conf->db->host;
}
if ($user == '')
{
$user = $conf->db->user;
}
if ($pass == '')
{
$pass = $conf->db->pass;
}
if ($name == '')
{
$name = $conf->db->name;
}
//print "Name DB: $host,$user,$pass,$name<br>";
// Essai connexion serveur
$this->db = $this->connect($host, $user, $pass,$name);
if ($this->db)
{
$this->connected = 1;
$this->ok = 1;
}
else
{
$this->connected = 0;
$this->ok = 0;
}
// Si connexion serveur ok et si connexion base demandée, on essaie connexion base
if ($this->connected && $name)
{
if ($this->select_db($name) == 1)
{
$this->database_selected = 1;
$this->ok = 1;
}
else
{
$this->database_selected = 0;
$this->ok = 0;
}
}
else
{
// Pas de selection de base demandée, ok ou ko
$this->database_selected = 0;
}
return $this->ok;
}
/**
\brief Selectionne une database.
\param database nom de la database
\return resource
\remarks ici postgresql n'a aucune fonction equivalente de mysql_select_db
\remarks comparaison manuel si la database est bien celle choisie par l'utilisateur
\remarks en cas de succes renverra 1 ou 0
*/
function select_db($database)
/**
\brief Ouverture d'une connection vers le serveur et une database.
\param type type de base de données (mysql ou pgsql)
\param host addresse de la base de données
\param user nom de l'utilisateur autorisé
\param pass mot de passe
\param name nom de la database
\return int 1 en cas de succès, 0 sinon
*/
function DoliDb($type = 'pgsql', $host = '', $user = '', $pass = '', $name = '')
{
if($database == "dolibarr")
return 1;
else
return 0;
global $conf;
$this->transaction_opened=0;
if ($host == '') $host = $conf->db->host;
if ($user == '') $user = $conf->db->user;
if ($pass == '') $pass = $conf->db->pass;
if ($name == '') $name = $conf->db->name;
//print "Name DB: $host,$user,$pass,$name<br>";
// Essai connexion serveur
$this->db = $this->connect($host, $user, $pass, $name);
if ($this->db)
{
$this->connected = 1;
$this->ok = 1;
}
else
{
$this->connected = 0;
$this->ok = 0;
}
// Si connexion serveur ok et si connexion base demandée, on essaie connexion base
if ($this->connected && $name)
{
if ($this->select_db($name) == 1)
{
$this->database_selected = 1;
$this->ok = 1;
}
else
{
$this->database_selected = 0;
$this->ok = 0;
}
}
else
{
// Pas de selection de base demandée, ok ou ko
$this->database_selected = 0;
}
return $this->ok;
}
/**
\brief Connection vers le serveur
\param host addresse de la base de données
\param login nom de l'utilisateur autorisé
\param passwd mot de passe
\param name nom de la database
\return resource handler d'accès à la base
*/
/**
\brief Selectionne une database.
\param database nom de la database
\return resource
\remarks ici postgresql n'a aucune fonction equivalente de mysql_select_db
\remarks comparaison manuel si la database est bien celle choisie par l'utilisateur
\remarks en cas de succes renverra 1 ou 0
*/
function connect($host, $login, $passwd, $name)
function select_db($database)
{
$con_string = "host=$host dbname=$name user=$login password=$passwd ";
$this->db = pg_connect($con_string);
return $this->db;
if($database == "dolibarr")
return 1;
else
return 0;
}
/**
\brief Connexion sur une base de donnée
\param database nom de la database
\return result resultat 1 pour ok, 0 pour non ok
*/
/**
\brief Connection vers le serveur
\param host addresse de la base de données
\param login nom de l'utilisateur autoris
\param passwd mot de passe
\param name nom de la database
\return resource handler d'accès à la base
*/
function create_db($database)
{
if(createdb($database,$this->db))
return 1;
else
return 0;
}
/**
\brief Copie d'une database.
\return resource
*/
function clone()
function connect($host, $login, $passwd, $name)
{
$db2 = new DoliDb("", "", "", "", "");
$db2->db = $this->db;
return $db2;
$con_string = "host=$host dbname=$name user=$login password=$passwd ";
$this->db = pg_connect($con_string);
return $this->db;
}
/**
\brief Ouverture d'une connection vers une database.
\param host addresse de la base de données
\param login nom de l'utilisateur autorisé
\param passwd mot de passe
\param name nom de la database
\return resource handler d'accès à la base
*/
/**
\brief Connexion sur une base de donnée
\param database nom de la database
\return result resultat 1 pour ok, 0 pour non ok
*/
function pconnect($host, $login, $passwd,$name)
function create_db($database)
{
$con_string = "host=$host dbname=$name user=$login password=$passwd";
$this->db = pg_pconnect($con_string);
return $this->db;
if(createdb($database, $this->db))
{
return 1;
}
else
{
return 0;
}
}
/**
\brief Fermeture d'une connection vers une database.
\return resource
*/
function close()
{
return pg_close($this->db);
}
/**
\brief Copie d'un handler de database.
\return resource
*/
/**
\brief Debut d'une transaction.
\param do
\return string
*/
function begin($do=1)
{
if ($do)
{
return $this->query("BEGIN");
}
else
{
return 1;
}
}
/**
\brief Ecriture d'une transaction.
\param do
\return string
*/
function commit($do=1)
{
if ($do)
{
return $this->query("COMMIT;");
}
else
{
return 1;
}
}
/**
\brief Effacement d'une transaction et retour au ancienne valeurs.
\param do
\return string
*/
function rollback($do=1)
{
if ($do)
{
return $this->query("ROLLBACK;");
}
else
{
return 1;
}
}
/**
\brief Effectue une requete et renvoi le resultset de réponse de la base
\param query contenu de la query
\param limit
\param offset
\return resource resultset
*/
function query($query, $limit="", $offset="")
function clone()
{
$query = trim($query);
$this->lastquery=$query;
$this->results = pg_query($this->db,$query);
return $this->results;
$db2 = new DoliDb("", "", "", "", "");
$db2->db = $this->db;
return $db2;
}
/**
\brief Liste des tables dans une database.
\param database nom de la database
\return resource
*/
/**
\brief Ouverture d'une connection vers une database.
\param host Adresse de la base de données
\param login Nom de l'utilisateur autorisé
\param passwd Mot de passe
\param name Nom de la database
\return resource handler d'accès à la base
*/
function list_tables($database)
{
$this->results = pg_query($this->db, "SHOW TABLES;");
return $this->results;
}
/**
\brief Renvoie les données de la requete.
\param nb contenu de la query
\param fieldname nom du champ
\return resource
*/
function result($nb, $fieldname)
function pconnect($host, $login, $passwd, $name)
{
return pg_fetch_result($this->results, $nb, $fieldname);
$con_string = "host=$host dbname=$name user=$login password=$passwd";
$this->db = pg_pconnect($con_string);
return $this->db;
}
/**
\brief Fermeture d'une connection vers une database.
\return resource
*/
/**
\brief Libère le dernier resultset utilisé sur cette connexion.
\return resource
*/
function free()
function close()
{
return pg_free_result($this->results);
return pg_close($this->db);
}
/**
\brief Renvoie la ligne courante (comme un objet) pour le curseur resultset.
\param resultset curseur de la requete voulue
\return resource
*/
/**
\brief Debut d'une transaction.
\return int 1 si ouverture transaction ok ou deja ouverte, 0 en cas d'erreur
*/
function fetch_object($resultset=0)
function begin()
{
if (! $this->transaction_opened)
{
$ret=$this->query("BEGIN;");
if ($ret) $this->transaction_opened++;
return $ret;
}
else
{
$this->transaction_opened++;
return 1;
}
}
/**
\brief Validation d'une transaction
\return int 1 si validation ok ou niveau de transaction non ouverte, 0 en cas d'erreur
*/
function commit()
{
if ($this->transaction_opened==1)
{
$ret=$this->query("COMMIT;");
if ($ret) $this->transaction_opened=0;
return $ret;
}
else
{
$this->transaction_opened--;
return 1;
}
}
/**
\brief Annulation d'une transaction et retour aux anciennes valeurs
\return int 1 si annulation ok ou transaction non ouverte, 0 en cas d'erreur
*/
function rollback()
{
if ($this->transaction_opened)
{
$ret=$this->query("ROLLBACK;");
$this->transaction_opened=0;
return $ret;
}
else
{
return 1;
}
}
/**
\brief Effectue une requete et renvoi le resultset de réponse de la base
\param query Contenu de la query
\return resource Resultset de la reponse
*/
function query($query)
{
$query = trim($query);
$this->lastquery=$query;
$this->results = pg_query($this->db, $query);
return $this->results;
}
/**
\brief Renvoie les données de la requete.
\param nb Contenu de la query
\param fieldname Nom du champ
\return resource
*/
function result($nb, $fieldname)
{
return pg_fetch_result($this->results, $nb, $fieldname);
}
/**
\brief Renvoie la ligne courante (comme un objet) pour le curseur resultset.
\param resultset Curseur de la requete voulue
\return resource
*/
function fetch_object($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return pg_fetch_object($resultset);
}
/**
\brief défini les limites de la requète.
\param limit
\param offset
\return int limite
*/
function plimit($limit=0,$offset=0)
{
if ($offset > 0)
{
return " LIMIT $offset,$limit ";
}
else
{
return " LIMIT $limit ";
}
}
/**
\brief Renvoie les données dans un tableau.
\param resultset Curseur de la requete voulue
\return array
*/
/**
\brief Formatage par la base de données d'un champ de la base au format Timestamp ou Date (YYYY-MM-DD HH:MM:SS)
afin de retourner une donnée toujours au format universel date tms unix.
\param fname
\return date
*/
function pdate($fname)
function fetch_array($resultset=0)
{
return "unix_timestamp($fname)";
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return pg_fetch_array($resultset);
}
/**
\brief Renvoie les données comme un tableau.
\param resultset Curseur de la requete voulue
\return array
*/
/**
\brief formatage de la date en fonction des locales.
\param fname
\return date
*/
function idate($fname)
function fetch_row($resultset=0)
{
return strftime("%Y%m%d%H%M%S",$fname);
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return pg_fetch_row($resultset);
}
/**
\brief Renvoie les données dans un tableau.
\return array
*/
function fetch_array()
{
return pg_fetch_array($this->results);
}
/**
\brief Renvoie les données comme un tableau.
\return array
*/
function fetch_row()
{
return pg_fetch_row($this->results);
}
/**
\brief Obtient les données d'un colonne et renvoie les données sous forme d'objet.
/**
\brief Obtient les données d'un colonne et renvoie les données sous forme d'objet.
\param resultset Curseur de la requete voulue
\return array
*/
*/
function fetch_field()
function fetch_field($resultset=0)
{
return pg_field_name($this->results);
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return pg_field_name($resultset);
}
/**
\brief Renvoie le nombre de lignes dans le resultat d'une requete SELECT
\see affected_rows
\param resultset Curseur de la requete voulue
\return int Nombre de lignes
*/
function num_rows($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return pg_num_rows($resultset);
}
/**
\brief Renvoie le nombre de lignes dans le resultat d'une requete INSERT, DELETE ou UPDATE
\see num_rows
\param resultset Curseur de la requete voulue
\return int Nombre de lignes
*/
function affected_rows($resultset=0)
{
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
// pgsql necessite un resultset pour cette fonction contrairement
// a mysql qui prend un link de base
return pg_affected_rows($resultset);
}
/**
\brief Renvoie le nombre de lignes dans le
resultat d'une requete SELECT
\see affected_rows
\return int nombre de lignes
*/
/**
\brief Renvoie le nombre de champs dans le resultat de la requete.
\param resultset Curseur de la requete voulue
\return int
*/
function num_rows()
function num_fields($resultset=0)
{
return pg_num_rows($this->results);
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return pg_num_fields($resultset);
}
/**
\brief Renvoie le nombre de lignes dans le
resultat d'une requete INSERT, DELETE ou UPDATE
\see num_rows
\return int nombre de lignes
*/
/**
\brief Libère le dernier resultset utilisé sur cette connexion.
\param resultset Curseur de la requete voulue
\return resource
*/
function affected_rows()
function free($resultset=0)
{
// pgsql necessite un resultset pour cette fonction contrairement
// a mysql qui prend un link de base
return pg_affected_rows($this->results);
// Si le resultset n'est pas fourni, on prend le dernier utilisé sur cette connexion
if (! is_resource($resultset)) { $resultset=$this->results; }
return pg_free_result($resultset);
}
/**
\brief Renvoie le nombre de champs dans le resultat de la requete.
\return int
*/
function num_fields()
/**
\brief Défini les limites de la requète.
\param limit
\param offset
\return int Limite
*/
function plimit($limit=0,$offset=0)
{
return pg_num_fields($this->results);
if ($offset > 0)
{
return " LIMIT $offset,$limit ";
}
else
{
return " LIMIT $limit ";
}
}
/**
\brief Renvoie la derniere requete soumise par la methode query()
\return lastquery
*/
function lastquery()
/**
\brief Formatage par la base de données d'un champ de la base au format Timestamp ou Date (YYYY-MM-DD HH:MM:SS)
afin de retourner une donnée toujours au format universel date tms unix.
\param fname
\return date
*/
function pdate($fname)
{
return $this->lastquery;
return "unix_timestamp($fname)";
}
/**
\brief Renvoie le texte de l'erreur mysql de l'operation precedente.
\return error_text
*/
function error()
/**
\brief Formatage de la date en fonction des locales.
\param fname
\return date
*/
function idate($fname)
{
return pg_last_error($this->db);
return strftime("%Y%m%d%H%M%S",$fname);
}
/**
\brief Renvoie la valeur numerique de l'erreur de l'operation precedente.
pour etre exploiter par l'appelant et détecter les erreurs du genre:
echec car doublons, table deja existante...
\return error_num
\remark pgsql ne permet pas de renvoyer un code générique d'une erreur,
mais juste un message. On utilise donc ces messages plutot qu'un code.
*/
function errno()
/**
\brief Renvoie la derniere requete soumise par la methode query()
\return lastquery
*/
function lastquery()
{
return pg_last_error($this->db);
return $this->lastquery;
}
/**
\brief Obtient l'id genéré par le précedent INSERT.
\return id
*/
/**
\brief Renvoie le texte de l'erreur mysql de l'operation precedente.
\return error_text
*/
function last_insert_id($tab)
function error()
{
$result = pg_query($this->db,"select max(rowid) from ".$tab." ;");
$nbre = pg_num_rows($result);
$row = pg_fetch_result($result,0,0);
return $row;
}
return pg_last_error($this->db);
}
/**
\brief Renvoie la valeur numerique de l'erreur de l'operation precedente.
pour etre exploiter par l'appelant et détecter les erreurs du genre:
echec car doublons, table deja existante...
\return error_num
\remark pgsql ne permet pas de renvoyer un code générique d'une erreur,
mais juste un message. On utilise donc ces messages plutot qu'un code.
*/
/**
\brief Retourne le dsn pear
\return dsn
*/
function errno()
{
return pg_last_error($this->db);
}
function getdsn($db_type,$db_user,$db_pass,$db_host,$dbname)
{
$pear = $db_type.'://'.$db_user.':'.$db_pass.'@'.
$db_host.'/'.$db_name;
/**
\brief Obtient l'id genéré par le dernier INSERT.
\return id
*/
return $pear;
}
function last_insert_id($tab)
{
$result = pg_query($this->db,"select max(rowid) from ".$tab." ;");
$nbre = pg_num_rows($result);
$row = pg_fetch_result($result,0,0);
return $row;
}
/**
\brief Retourne le dsn pear
\return dsn
*/
function getdsn($db_type,$db_user,$db_pass,$db_host,$dbname)
{
$pear = $db_type.'://'.$db_user.':'.$db_pass.'@'.
$db_host.'/'.$db_name;
return $pear;
}
/**
\brief Liste des tables dans une database.
\param database Nom de la database
\return resource
*/
function list_tables($database)
{
$this->results = pg_query($this->db, "SHOW TABLES;");
return $this->results;
}
}