Classe connection

Paramètres

• con_id - Identifiant de connexion
• error - Dernière erreur de la base de données
• errorno - Numéro de la dernière erreur
• chache_dir - Chemin vers le dossier de cache
• cache_uptime - Timestamp de mise à jour du cache

Méthodes

connection

void connection ($user, $pwd, $alias, $dbname)

Paramètres

• user - ID de l'utilisateur
• pwd - Mot de passe
• alias - Serveur auquel se connecter
• dbname - Nom de la base de données

Constructeur. Initialise la connection à la base de données.

database

boolean database ($dbname)

Paramètres

• dbname - Nom de la base de données

Change de base de données. Renvoie vrai en cas de succès.

close

boolean close ()

Ferme la connection à la base de données et renvoie vrai en cas de succès.

select

recordset select ($query, [$class='recordset'], [$cache=true])

Paramètres

• query - Requête SQL
• class - Type d'objet à renvoyer
• cache - Utiliser le cache

Execute une requête SQL et renvoie le resultat dans une instance de l'objet dont le type est défini par $class. Le type d'objet par défaut est un recordset.

La paramètre $cache n'a d'influence que si le cache a été activée (méthode setCache).

N'importe quel objet peut-être utilisé à la place du recordset du moment qu'il prend un tableau multidimmensionel comme premier argument de son constructeur.

Cette méthode renvoie false en cas d'erreur.

execute

boolean execute ($query)

Paramètres

• query - Requête SQL

Cette méthode exécute la requête $query et renvoi vrai si aucune erreur ne s'est produite, faux dans le cas contraire.

getLastID

string getLastID ()

Cette méthode renvoie le dernier ID inséré et créé par auto incrémentation.

setError

void setError ()

Cette méthode référence la dernière erreur du moteur de base de données dans les propriétés error et errorno.

Le résultat de cette méthode privée est exploitable par la méthode error.

error

string error ()

Renvoie la dernière erreur de la base de données dans le format numéro - erreur. Renvoie faux si aucune erreur.

escapeStr

string escapeStr ($str)

Paramètres

• str - Chaîne à protéger

Cette méthode formate une chaîne de caractères pour la protéger lors de son insertion dans une requête SQL.

setCache

void setCache ($dir, $uptime, [$ttl='-24 hours'])

Paramètres

• dir - Emplacement du répertoire de cache
• uptime - Timestamp de mise à jour du cache
• ttl - Temps de vie des fichiers du cache

Initialise le cache de requêtes SQL. L'uptime permet d'indiquer un timestamp pour lequel les données sont à jour dans le cache.

_getFromCache

recordset _getFromCache ($query)

Paramètres

• query - Requête SQL

Cette méthode privée vérifie si un fichier est exploitable dans le cache et renvoie un recordset contenant les données le cas échéant.

_putInCache

void _putInCache ($query, $rs)

Paramètres

• query - Requête SQL
• rs - Données à mettre en cache

Cette méthode met les données dans un fichier cache. Celles-ci sont enregistrées sous la forme d'un recordset sérializé.