Les fonctions spéciales MySQL

Fonctions de base
SetHost(), SetLogin(), SetPassword(), SetBase()

Les fonctions SetHost(), SetLogin(), SetPassword(), SetBase() servent à initialiser les variables pour la connection.

Il est préférable de les configurer à partir du fichier TPLN_Cfg.php dans le répertoire TPLN pour éviter d'appeler ces fonctions à chaque fois.

  •  SetHost( string host )
  •  SetLogin( string login )
  •  SetPassword( string password )
  •  SetBase( string base )
Exemple :

SetBase :

$TPLN->SetBase("my_base"); // change la base par défaut



 
DbConnect()

La fonction DbConnect() sert se connecter à votre base de données MySQL.

DbConnect( )

Exemple :

DbConnect() :

$TPLN->DbConnect();

 

 
DbClose()

La fonction DbClose() sert se déconnecter à votre base de données MySQL.

DbClose( )

Exemple :

DbClose() :

$TPLN->DbClose();

 

 
DoQuery()

La fonction DoQuery() sert effectuer une requete.

DoQuery(string query )

Exemple :

DoQuery() :

$TPLN->DoQuery("SELECT * FROM my_table");

 

 
GetData()

La fonction GetData() sert retourner les résultats de la requete.
Si le paramètre COUNT est passé alors le résultats retourné valable pour les requete de type count().

GetData( [COUNT] )

Exemple :

GetData() pour un requete normale:

$TPLN->DoQuery("SELECT * FROM my_table");
$res = $TPLN->GetData();

GetData() pour un requete avec count:

$TPLN->DoQuery("SELECT COUNT(*) FROM my_table");
$count = $TPLN->GetData(COUNT);


 
GetRowsCount()

La fonction GetRowsCount() sert retourner le nombre de résultats de la requête.

GetRowsCount( )

Exemple :

GetRowsCount() :

$TPLN->DoQuery("SELECT * FROM my_table");
$nb_results = $TPLN->GetRowsCount();


Cette fonction est similaire à DBNumRows()
 
DBNumRows()

La fonction DBNumRows() sert à retourner le nombre de résultats de la requête.
C'est une alias de la fonction GetRowsCount()

DBNumRows( )

Exemple :

DBNumRows() :

$TPLN->DoQuery("SELECT * FROM my_table");
$nb_results = $TPLN->DBNumRows();


 
DBFetchArray()

La fonction DBFetchArray() sert à retourner une ligne de résultat sous la forme d'un tableau associatif. Equivaut à la fonction Php mysql_fetch_array()

DBFetchArray( )

Exemple :

DBFetchArray() :

$TPLN->DoQuery("SELECT * FROM my_table");
while($row = $TPLN->DBFetchArray())
{echo $row["user_id"];}


Voir aussi: DBFetchAssoc() et ParseDBrows()

 
DBFetchAssoc()

La fonction DBFetchAssoc() sert à retourner une ligne de résultat sous la forme d'un tableau associatif. Equivaut à la fonction Php mysql_fetch_assoc()

DBFetchAssoc( )

Exemple :

DBFetchAssoc() :

$TPLN->DoQuery("SELECT * FROM my_table");
while($row = $TPLN->DBFetchAssoc())
{...}


Voir aussi: DBFetchArray() et ParseDBrows()

 
DBFreeResult()

La fonction DBFreeResult() n'est à appeler que si vous avez peur d'utiliser trop de mémoire durant l'exécution de votre script. Toute la mémoire associée à l'identifiant de résultat sera automatiquement libérée.

Equivaut à la fonction Php mysql_free_result()

DBFreeResult( )


Voir aussi: DBFetchArray() et ParseDBrows()

 
ParseDBRow()

La fonction ParseDBRow() sert à parser toutes les variables d'un bloc par les valeurs retournées par row de votre requête.

ParseDBRow(string bloc)

Exemple :

 

$TPLN->DoQuery("SELECT * FROM my_table");
$TPLN->ParseDbRow("bloc1");


 
 
La fonction ShowRecords()
ShowRecords()

La fonction ShowRecords() est une fonction qui permet de parser les données provenant de MySQL, vous n'avez qu'à créer votre template et la fonction s'occupe de tout pour vous !

Votre template doit être configurer comme ceci :

  • <bloc::data>
  •    <bloc::loop> </bloc::loop> contient le nom de vos champs en variable
  •     <bloc::norecord> </bloc::norecord> contient le message s'il n'y a pas de résultats
  • </bloc::data>
Exemple :

<html>
<body>

<bloc::data>
  Données <br><br>
  <bloc::loop> {champs_nom} <br> </bloc::loop>
   <bloc::norecord>Pas de résultas</bloc::norecord>

</bloc::data>
</body>
</html>

ShowRecords( string query , int resultsbypage )

Exemple :

ShowRecords() :

$query = "SELECT * FROM my_table";
$TPLN->ShowRecords($query,10);

Cette fonction possède ses variables propriétaires qui sont parsées automatiquement celles ci doivent être présentes dans le bloc <bloc::data></bloc::data> elles sont notées comme ceci {_Variable}

  • _First indique la position du première enregistrement
  • _Last indique la position du dernier enregistrement
  • _Count indique le nombre de résultats
  • _PageNumber indique la page actuelle
  • _PageCount indique le nombre de page total
  • _UrlBng url de la première page (texte défini dans TPLN_Cfg.php ou par SetNavLabels() )
  • _UrlPrev url de la page précédente ( texte défini dans TPLN_Cfg.php ou par SetNavLabels() )
  • _UrlNext url de la page suivante ( texte défini dans TPLN_Cfg.php ou par SetNavLabels() )
  • _UrlEnd url de la dernière page ( texte défini dans TPLN_Cfg.php ou par SetNavLabels() )
  • _UrlPageNav sert à la pagination de vos résultats
  • _ NavColor remplace par l'un des deux couleurs spécifiés dans le fichier TPLN_Cfg.php ou par SetNavColor()

 

 
SetNavLabels()

La fonction SetNavLabels() permet de remplacer le texte présent dans _UrlBng, _UrlPrev, _UrlNext, _UrlEnd.

SetNavLabels(string bngtxt , string prevtxt , string nexttxt , string endtxt )

Exemple :

SetNavLabels() :

$TPLN->SetNavLabels("[<<]","[<]","[>]","[>>]");

 

 
SetNavColor()

La fonction SetNavColor() permet d'alterner les couleurs pour pour l'item {_NavColor}

SetNavColor(string color1 , string color2 )

Exemple :

SetNavColor() :

$TPLN->SetNavColor("#CCCCCC","#FFFFFF");

 

 
AddUrlVar()

La fonction AddUrlVar() permet d'ajouter une variable dans l'url de_UrlBng, _UrlPrev, _UrlNext, _UrlEnd, _UrlPageNav.

AddUrlVar(string var )

Exemple :

SetNavLabels() :

$TPLN->AddUrlVar("var=my_var");

 

AddHtmlUrl()

La fonction AddHtmlUrl() permet d'ajouter des attributs Html entre les balises
<a [ajout]></a> de_UrlBng, _UrlPrev, _UrlNext, _UrlEnd, _UrlPageNav.

AddHtmlUrl(string string )

Exemple :

SetNavLabels() :

$TPLN->AddHtmlUrl("class=title");// va ajouter un style title au lien

 

 
SetUrl()

La fonction SetUrl() permet de changer le lien de_UrlBng, _UrlPrev, _UrlNext, _UrlEnd, _UrlPageNav.

SetUrl(string url )

Si cette fonction n'est pas utilisée TPLN choisi le fichier appelé par defaut.