CLASSE FRANCOPHONE D'EXPLOITATION MYSQL

<?php
/****************************************************************************************
Classe pour la manipulation de bases de données MySQL
Auteur : Mathieu ROBIN
Créée le : 02/04/2007
Dernière modification le : 24/12/2007
Commentaires : le constructeur connecte automatiquement l'instance de la classe à la base
*****************************************************************************************/

class DBMySql
{
	/**
	 * Identifiant de connection
	 *
	 * @var Entier
	 */
	private $ConnectionID;
	/**
	 * Variable de stockage de résultat
	 *
	 * @var Multiple
	 */
	private $result;
	/**
	 * Ligne de table ou de résultat de requête
	 *
	 * @var Tableau
	 */
	private $ligne;
	/**
	 * Serveur hôte de la base de données
	 *
	 * @var Chaîne
	 */
	private $serveur="";
	/**
	 * Nom de la base de données
	 *
	 * @var Chaîne
	 */
	private $base="";
	/**
	 * Utilisateur de la base de données
	 *
	 * @var Chaîne
	 */
	private $utilisateur="";
	/**
	 * Mot de passe de l'utilisateur de la base de données
	 *
	 * @var Chaîne
	 */
	public $mdp="";


	/**
	 * Constructeur
	 *
	 * @param Chaîne $serveur
	 * @param Chaîne $utilisateur
	 * @param Chaîne $mdp
	 * @param Chaîne $bdd
	 * @param Entier $ctID Identifiant de connection
	 * @return DBMySql
	 */
	function DBMySql($serveur, $utilisateur, $mdp, $base, $ctID=0)
	{
		$this->serveur=$serveur;
		$this->utilisateur=$utilisateur;
		$this->mdp=$mdp;
		$this->base=$base;
		$this->ConnectionID=$ctID;
		$retour=$this->ConnectionID;
		try
		{
			$this->Connection($this->serveur, $this->utilisateur, $this->mdp, $this->base);
		}
		catch (Exception $Except)
		{
			$retour=false;
		}
		return($retour);
	}


	/**
	 * Ouvre une connexion à un serveur MySQL
	 *
	 * @param Chaîne $serveur
	 * @param Chaîne $utilisateur
	 * @param Chaîne $mdp
	 * @param Chaîne $bdd
	 * @return Booléen
	 */
	function Connection($serveur, $utilisateur, $mdp, $base)
	{
		try
		{
			$this->ConnectionID=mysql_connect($serveur, $utilisateur, $mdp);
			return($this->SelectBDD($base));
		}
		catch (Exception  $Except)
		{
			return(false);
		}
	}

	/**
	 * Sélectionne une base de données
	 *
	 * @param Chaîne $bdd
	 * @return Booléen
	 */
	function SelectBDD($bdd)
	{
		$this->base=$bdd;
		try
		{
			return(mysql_select_db($bdd, $this->ConnectionID));
		}
		catch(Exception $Except)
		{
			return(false);
		}
	}

	/**
	 * Envoie une requête de mise à jour et retourne combien de lignes ont été affecté par l'opération
	 *
	 * @param Chaîne $sql
	 * @return Tableau
	 */
	function ReqUPDATE($sql)
	{
		if(preg_match("#^UPDATE (.){1,} SET (.){1,};$#i", $sql))
		{
			try
			{
				mysql_query($sql);
				$this->result=mysql_affected_rows();
				$retour[0]=$this->result;
				$retour[1]=true;
			}
			catch(Exception $Except)
			{
				$retour[0]=0;
				$retour[1]=false;
				$retour[2]=$Except->getMessage();
			}
		}
		else
		{
			$retour[0]=0;
			$retour[1]=false;
			$retour[2]="Mauvais format";
		}
		return($retour);
	}

	/**
	* Envoie une requête d'insertion et retourne l'identifiant automatique généré par MySQL pour cette insertion
	*
	* @param Chaîne $sql
	* @return Tableau
	*/
	function ReqINSERT($sql)
	{
		if(preg_match("#^INSERT INTO (.){1,} VALUES (.){1,};$#i", $sql))
		{
			try
			{
				mysql_query($sql);
				$this->result=mysql_insert_id();
				$retour[0]=$this->result;
				$retour[1]=true;
			}
			catch (Exception $Except)
			{
				$retour[0]=0;
				$retour[1]=false;
				$retour[2]=$Except->getMessage();
			}
		}
		else
		{
			$retour[0]=0;
			$retour[1]=false;
			$retour[2]="Mauvais format";
		}
		return($retour);
	}

	/**
	* Envoie une requête de suppression et retourne combien de lignes ont été affecté par l'opération
	*
	* @param Chaîne $sql
	* @return Tableau
	*/
	function ReqDELETE($sql)
	{
		if(preg_match("^DELETE FROM (.){1,};$#i",$sql))
		{
			try
			{
				mysql_query($sql);
				$this->result=mysql_affected_rows();
				$retour[0]=$this->result;
				$retour[1]=true;
			}
			catch (Exception $Except)
			{
				$retour[0]=0;
				$retour[1]=false;
				$retour[2]=$Except->getMessage();
			}
		}
		else
		{
			$retour[0]=0;
			$retour[1]=false;
			$retour[2]="Mauvais format";
		}
		return($retour);
	}

	/**
	* Envoie une requête de sélection et retourne combien de lignes sont sélectionnées
	*
	* @param Chaîne $sql
	* @return Tableau
	*/
	function ReqSELECT($sql)
	{
		if(preg_match("#^SELECT (.){1,} FROM (.){1,};$#i", $sql))
		{
			try
			{
				$this->result=mysql_query($sql);
				$retour[0]=mysql_num_rows($this->result);
				$retour[1]=true;
			}
			catch (Exception $Except)
			{
				$retour[0]=0;
				$retour[1]=false;
				$retour[2]=$Except->getMessage();
			}
		}
		else
		{
			$retour[0]=0;
			$retour[1]=false;
			$retour[2]="Mauvais format";
		}
		return($retour);
	}


	/**
	* Retourne la valeur maximale d'un champ dans une table
	*
	* @param Chaîne $table Table
	* @param Chaîne $champ
	* @return Entier
	*/
	function MaxChamp($table, $champ)
	{
		return($this->ReqSELECT("SELECT MAX(".$champ.") FROM ".$table));
	}

	/**
	* Retourne le nombre de lignes d'un résultat MySQL
	*
	* @return Tableau
	*/
	function NbrLignes()
	{
		try
		{
			$retour[0]=mysql_num_rows($this->result);
			$retour[1]=true;
		}
		catch (Exception $Except)
		{
			$retour[0]=0;
			$retour[1]=false;
			$retour[2]=$Except->getMessage();
		}
		return($retour);
	}

	/**
	* Retourne le nombre de lignes affectées lors de la dernière opération MySQL
	*
	* @return Entier
	*/
	function TuplesAffect()
	{
		return(mysql_affected_rows());
	}

	/**
	* Retourne l'identifiant généré par la dernière requête INSERT MySQL
	*
	* @return Entier
	*/
	function IDInsertion()
	{
		return(mysql_insert_id($this->ConnexionID));
	}

	/**
	* Retourne le texte associé avec l'erreur générée lors de la dernière requête
	*
	* @return Chaîne
	*/
	function Erreur()
	{
		return(mysql_error());
	}

	/**
	* Ferme une connection MySQL
	*
	* @return Booléen
	*/
	function Deconnection()
	{
		return(mysql_close());
	}
}
?>

23 décembre 2007 12:11:25 :

Je me suis trompé, j'avais mis la source en "initié", alors que c'est du niveau "débutant".

23 décembre 2007 12:42:38 :

Euh des petites infos privées oubliées XD

24 décembre 2007 18:57:51 :

Quelques modifications ont été apporté, notamment concernant la gestion des erreurs. C'est pas fini, mais ça s'améliore. J'ai provisoirement supprimé la fonction "tuplesuivant" parce qu'elle n'est effectivement pas terrible. Je suis en train de la refaire et fera l'objet d'une nouvelle version prochainement ;) Joyeux Noël et bon réveillon à tous!

24 décembre 2007 18:59:48 :

petite erreur dans une des expressions rationelles