pgsql
Classe PGsql destinée à faire de l' abstraction de bdd (entre autres).
La classe PGsql reprend les principales fonctionnalités des fonctions PHP associées. Son but, n est donc pas de remplacer ces fonctions, mais de vous permettre , eventuellemnt, de faire de l' abstraction de base de donnée.
La classe integre aussi la fonctionnalité de cache de donnée ainsi qu'une methode facilitant la manipulation de blobs. Les reglages du ramasse miette sont effectués dans la classe elle même avec la variable $Bdd->gc_time=86400 le chemin du répertoire de cache se gere de même avec $Bdd->cache_path='cache'. Lors de la mise en place de la classe penser a créer le répertoire de cache.
Les Méthodes
- PGsql - Nouvelle Instance
- connect - Connection et sélection de la Base
- Send_Query - Envoyez une requete
- num_rows - Nombre de résultat(s) retourné(s) par une requete
- get_cached_data - Envoie une requete et met le resultat au cache
- prepare_blob - Prepare un binaire, a être inséré dans une requête pgsql.
Exemples
- Exemple Minimal - Connection à la Base de donnée et selection de la base
- Envoi d' une requete
- Récupération et affichage des Résultats ARRAY (1)
- Récupération et affichage des Résultats ARRAY (2)
- Récupération et affichage des Résultats OBJET
- Libérer les résulats, et fermer la connexion
- Fonctionnement du cache de données
- Manipulation des blobs
Description des Méthodes
Nouvelle Instance
PGsql( string Host, string User, string Password, string Base , void Port)
Nouvelle Instance.
$Bdd = new PGsql('localhost', 'root', 'password', 'base', 80)
Connection et sélection de la Base
connect( string Host, string User, string Password, string Base , void Port)
Cette methode sert à se connecter au serveur pgSQL et de sélectionner la base de donnée ou l' on va travailler.
- Host : L' adresse de votre serveur pgSQL.
- User : Votre login de connexion.
- Password : Votre Password de connexion.
- Base : La base sur laquelle on va travailler.
- Port : Le port.
$Bdd -> connect('localhost', 'root', 'password', 'base', 80)
Envoyez une requete
Send_Query( string Query [, resource Link])
Envoie une requete SQL. L'appel de $Bdd->connect() n'est pas nécessaire avant, la connexion étant effectuée automatiquement.
- Query : La requete à envoyer.
- Link : Parametre optionnel. Resource renvoyée par connect().
$Bdd -> Send_Query( 'SELECT truc FROM machin' )
Nombre de résultat(s) retourné(s) par une requete
num_rows()
Se substitue a pg_num_rows() ET a pg_affected_rows. Renvoie le nombre de résultat(s) renvoyé(s) par la dernière requete.
$Bdd -> num_rows()
Envoie une requete et met le resultat au cache
get_cached_data( string Request, int time)
get_cached_data, vérifie que le resultat n'est pas ds le cache de donnée, et au besoin execute la requete. puis renvoie le résultat sous forme d'un tableau associatif comme le ferait pg_fetch_array(), enfin il met a jour le cache.
- Request : la requete SQL SELECT.
- Delay : La durée de validité du resultat lmis dans le cache.
$Bdd -> get_cached_data('SELECT machin FROM truc', 600)
Prepare un binaire, a être inséré dans une requête pgsql.
prepare_blob( string filename)
prepare_blob() ajoute les slash devant tous les éléments binaires qui posent probleme lors de l'insertion d'un binaire dans une requete pgsql et renvoie le resultat. Vous pourrez ainsi facilement insérer un fichier ds vos base de donnée. Le probleme ne se pose qu'a l'insertion ( INSERT, UPDATE) dans la base Lors du retrait ( SELECT ) le binaire passe sans souci à php.
- filename : le chemin vars le fichier a utiliser.
$file = $Bdd -> prepare_blob( 'path/filename' )
