dcTips() - Trucs divers

Clearbricks : quelques autres fonctions de dbLayer

Moe — Mon, 31 Dec 2007 18:06:00 +0100

Dans le billet d'introduction (qu'il est préférable d'avoir lu avant d'aborder ce billet) nous avons vu comment effectuer des requêtes avec la fonction select() de dbLayer. Après avoir découvert comment lire les enregistrements dans la base de données, nous allons ici voir comment insérer, mettre à jour et effacer des enregistrements.

Voici pour rappel la table des lecteurs que nous avons utilisé comme exemple dans le billet d'introduction :

La table lecteurs

lecteurs
id	nom	role
1	Pierre	clown
2	Paul	développeur
3	Jacques	soutien moral
4	Olivier	chef
5	Kozlika	fée

Le curseur

Pour insérer ou mettre à jour un enregistrement avec dbLayer, il faut d'abord ouvrir un curseur. Cela se fait avec la commande openCursor() et permet de définir sur quelle table on va agir. Ici ce sera la table lecteurs.

Ouvrons un curseur :


$cur = $con->openCursor('lecteurs');

$cur est un cursor, ou curseur en français. Nous allons lui attribuer des variables qui correspondent aux colonnes de la table et des valeurs grâce à la syntaxe suivante :


$cur->variable = valeur;

Exemples :

Pour définir le nom :


$cur->nom = 'César';

Pour définir le rôle :


$cur->role = 'empereur';

Insérer un enregistrement avec la fonction `insert()`

Un nouveau lecteur est arrivé, il s'appelle Hector et son rôle est "évangéliste". Comment faire pour l'ajouter à la table des lecteurs ? On ouvre un curseur, on lui attribue des valeurs :


$cur = $con->openCursor('lecteurs');
$cur->nom = 'Hector';
$cur->role = 'évangéliste';

Ensuite on utilise la fonction insert(), elle va récupérer les variables et les valeurs pour les insérer dans la table :


$cur->insert();

Voici le code complet :


$cur = $con->openCursor('lecteurs');
$cur->nom = 'Hector';
$cur->role = 'évangéliste';
$cur->insert();

Et la table après l'insertion :

lecteurs
id	nom	role
1	Pierre	clown
2	Paul	développeur
3	Jacques	soutien moral
4	Olivier	chef
5	Kozlika	fée
6	Hector	évangéliste

Un enregistrement a été créé. Notez que l'id de cet enregistrement vaut 6 car la base de données a été configurée pour incrémenter l'id à chaque nouvel enregistrement.

Modifier un enregistrement avec la fonction `update()`

Pierre n'est plus clown, il est devenu professeur. Comment mettre à jour l'enregistrement de la table qui le concerne ? On ouvre un curseur et on attribue les nouvelles valeurs :


$cur = $con->openCursor('lecteurs');
$cur->role = 'professeur';

Puis on utilise la fonction update(), Le mot-clé WHERE permet de définir quel enregistrement nous allons mettre à jour, ici on veut modifier l'enregistrement de Pierre donc nous allons sélectionner l'enregistrement où le nom est "Pierre" :


$cur->update('WHERE nom = \'Pierre\';');

Voici le code complet :


$cur = $con->openCursor('lecteurs');
$cur->role = 'professeur';
$cur->update('WHERE nom = \'Pierre\';');

Et le résultat :

lecteurs
id	nom	role
1	Pierre	professeur
2	Paul	développeur
3	Jacques	soutien moral
4	Olivier	chef
5	Kozlika	fée
6	Hector	évangéliste

L'enregistrement a été mis à jour.

Effacer un enregistrement avec la fonction `execute()`

Il n'y a pas de fonction spéciale pour effacer un enregistrement, nous allons utiliser la commande execute() qui sert à exécuter des requêtes SQL.

Jacques n'est plus lecteur, Comment effacer l'enregistrement qui le concerne ? Voici la requête SQL qui va effacer l'enregistrement avec l'id 3 : DELETE FROM lecteurs WHERE id = 3;

On exécute la requête :


$query = 'DELETE FROM lecteurs WHERE id = 3;';
$con->execute($query);

Et la table devient :

lecteurs
id	nom	role
1	Pierre	professeur
2	Paul	développeur
4	Olivier	chef
5	Kozlika	fée
6	Hector	évangéliste

Notez qu'on aurait pu réaliser la même action avec cette requête SQL :


$query = 'DELETE FROM lecteurs WHERE nom = \'Jacques\';';

Quelques fonctions supplémentaires pour les recordsets

Ces fonctions permettent d'obtenir des informations sur les requêtes SELECT décrites dans le billet d'introduction.

`isEmpty()`

Cette fonction retourne true si un recordset est vide ou false sinon. Elle s'utilise dans une condition, pour voir si un recordset contient des enregistrements. Ici on va afficher les noms des lecteurs dont l'id est supérieur à 3 :


$query = 'SELECT nom FROM lecteurs WHERE id > 3;';
$rs = $con->select($query);

if ($rs->isEmpty())
{
    echo('aucun lecteur');
}
else
{
    while ($rs->fetch()) {echo($rs->f('nom').' ');}
}

Ce code affichera "aucun lecteur" si le recordset est vide et affichera les noms des lecteurs s'il y en a.

Pour ne pas afficher de message spécifique en cas de recordset vide on utilisera le code suivant :


$query = 'SELECT nom FROM lecteurs WHERE id > 3;';
$rs = $con->select($query);

if (!$rs->isEmpty())
{
    while ($rs->fetch()) {echo($rs->f('nom').' ');}
}

`count()`

Cette fonction retourne le nombre d'enregistrements présents dans un recordset :


$query = 'SELECT nom FROM lecteurs WHERE id > 3;';
$rs = $con->select($query);

echo('nombre d\'enregistrements : '.$rs->count);

Ceci affichera par exemple "nombre d'enregistrements : 2".

Conclusion

Grâce au billet précédent et à ce billet, vous savez lire et modifier des enregistrements dans des tables d'une base de données. Pour apprendre comment créer ou modifier des tables, voyez la documentation de Dotclear, Vous êtes prêts à gérer des tables dans une base de données avec Clearbricks.

Si les commentaires sont fermés, vous pouvez commenter ce billet sur mon blog.

Clearbricks : découverte de dbLayer et de sa fonction select()

Moe — Thu, 22 Nov 2007 19:22:00 +0100

Introduction à Clearbricks

Dotclear utilise son propre framework qui n'est pas un framework : Clearbricks, il est composé d'une ensemble de classes et de fonctions, on y trouve par exemple une classe destinée à traiter les chaînes HTML ou une classe servant à formater les dates. Nous allons nous intéresser à la classe dbLayer.

La base de données

Comme son nom l'indique, c'est une base ... de données. Concrètement, ça stocke des informations sous forme de tables (qui sont des tableaux) dans lesquelles on peut sélectionner des informations, les trier ou ajouter une information, etc. Pour cela on utilise des requêtes écrites en langage SQL. Ce langage est un standard et permet de faire des requêtes à différents types de base de données^[1]. Clearbricks peut se connecter à trois types de bases de données : MySQL, PostgreSQL (noté aussi PGSQL) et SQLite (très peu utilisé).

La classe dbLayer

dbLayer est le diminutif de database layer, ou couche de la base de données en français. C'est une couche d'abstraction, ce qui signifie qu'on fait appel à dbLayer pour réaliser des actions (ici des requêtes SQL) sans se soucier de ce qu'il y a en-dessous. Au lieu d'utiliser les fonctions de PHP telles que mysql_query() et pg_query() on utilisera les fonctions de dbLayer en faisant abstraction du type de la base de données.

On peut schématiser ainsi le cheminement d'une requête SQL :

Grâce à Clearbricks et dbLayer, on a un code qui gère indifféremment les 2 types de base de données.

La table lecteurs

Imaginons qu'on ait créé une table lecteurs :

lecteurs
id	nom	role
1	Pierre	clown
2	Paul	développeur
3	Jacques	soutien moral
4	Olivier	chef
5	Kozlika	fée

Cette table est un tableau composé de 3 champs (les colonnes) : id (l'identifiant de la ligne) correspondant à l'ordre dans lequel les lecteurs se sont enregistrés, nom (le nom des utilisateurs) et role qui est le rôle de l'utilisateur. Cette table compte 5 enregistrements (les lignes). Elle servira d'exemple dans ce billet.

Admettons que la connexion a la base de données a été effectuée, c'est l'objet $con. Nous allons voir comment utiliser la fonction select().

Première requête sur un enregistrement et un champ

Comment faire pour afficher le nom du premier lecteur ?

Voici la requête en pseudo-code : "sélectionner nom dans la table lecteurs où id = 1" et en SQL :

$query = 'SELECT nom FROM lecteurs WHERE id = 1;';

Effectuons la requête :

$rs = $con->select($query);

$rs est un recordset, c'est un groupe d'enregistrements (ici un seul) qui contient les champs (ici le champ nom). On accède au champ nom grâce à la fonction field() ou sa version raccourcie f(), on l'affiche ainsi :

echo($rs->f('nom'));

Ceci affichera "Pierre". Notez qu'il existe une syntaxe simplifiée pour afficher le même résultat :

echo($rs->nom);

On peut aussi effectuer la même opération en une ligne :

echo($con->select($query)->nom);

Une requête sur un champ avec plusieurs enregistrements

Comment afficher les noms des derniers lecteurs ?

Voici la requête en pseudo-code : "sélectionner nom dans la table lecteurs en rangeant par id décroissant en se limitant à 2 enregistrements" et en SQL :

$query = 'SELECT nom FROM lecteurs ORDER BY id DESC LIMIT 2;';

Effectuons la requête :

$rs = $con->select($query);

Le recordset $rs contient 2 enregistrements, on ne peut plus accéder directement au champ nom des 2 enregistrements avec f('nom'). On va parcourir les enregistrements avec une boucle grâce à la fonction fetch() :

while ($rs->fetch()) {echo($rs->f('nom').' ');}

Ceci va afficher "Kozlika Olivier".

Une requête sur plusieurs champs de plusieurs enregistrements

Comment afficher les noms et les rôles des 3 premiers lecteurs ?

Voici la requête en pseudo-code : "sélectionner nom et rôle dans la table lecteurs par id croissant en se limitant à 3 enregistrements" et en SQL :

$query = 'SELECT nom,role FROM lecteurs ORDER BY id ASC LIMIT 3;';

Effectuons la requête :

$rs = $con->select($query);

Le recordset $rs contient 3 enregistrements et 2 champs, on va devoir parcourir les enregistrements comme précédemment :

while ($rs->fetch()) {echo($rs->f('nom').' : '.$rs->f('role').' ');}

Ceci va afficher "Pierre : clown Paul : développeur Jacques : soutien moral".

Conclusion

Désormais vous savez utiliser les fonctions de dbLayer pour effectuer des requêtes SQL de type SELECT.

Si les commentaires sont fermés, vous pouvez commenter ce billet sur mon blog en attendant la réouverture des commentaires sur ce blog.

Merci à Kozlika, Franck Paul et Biou pour leurs conseils et le temps qu'ils m'ont accordé.

Notes

[1] le langage peut différer d'un type à l'autre

Fermeture pendant les travaux

Kozlika — Thu, 22 Nov 2007 10:53:00 +0100

Les commentaires et rétroliens sont fermés pour quelque temps pendant la refonte de l'organisation de klafoutis.org

C'est pas grave, de toutes façons le meilleur endroit pour poser des questions c'est http://dotclear.net/forum/ :)

Bonjour, c'est pour un sondage...

Kozlika — Sat, 21 Apr 2007 05:46:00 +0000

La rédaction de la documentation pour les versions 1.2 et 2.0 de Dotclear arrivant à son terme (du moins pour les parties dont je peux m'occuper), je vais pouvoir reprendre les tutoriels pour dc 2.0 ici. J'en vois quatre catégories possibles pour ce qui concerne les thèmes :

Portage des thèmes de 1.2 vers 2.0
Comment personnaliser un thème existant (en partant de celui par défaut par exemple) ?
Un thème en kit (dans l'esprit de celui pour 1.2)
Créer un thème pour Dotclear de A à Z.

Par quoi je commence ? Ou vous avez d'autres besoins / souhaits non compris dans l'un des quatre sujets précédents ?

Et je recrute aussi. Par ailleurs, pour ceux qui voudraient donner un coup de main, j'ai quelques idées sur la question :)

Total Validator

Kozlika — Tue, 10 Apr 2007 19:22:00 +0200

Pinaise les gens, je viens de trouver l'arme ultime, le couteau suisse de la validation, le top du must : Total Validator. C'est pas trop d'la bombe de balle ? (Via Veerle Blog.)

Apportez votre pierre à l'édifice !

Kozlika — Thu, 08 Mar 2007 10:22:00 +0000

Vous avez constaté des trous dans la documentation de Dotclear

Vous y avez relevé des erreurs ou fautes d'orthographe ?

Vous trouvez telle explication peu claire ou incomplète, telle formulation à revoir ?

Vous avez installé un blog sur un autre hébergement que ceux déjà listés et vous pourriez rédiger un pas à pas sur l'un de ces modèles ?

Vous avez installé plusieurs blogs avec une autre méthode que celles-ci ?

Vous avez des suggestions diverses et variées ?

Contribuez à l'amélioration de la documentation, envoyez vos mails à documentation(@)dotclear(.)net. Quel que soit votre niveau vous pouvez nous aider, ne serait-ce qu'en expérimentant son utilisation.

Et si vous faites partie des pressés pour la sortie de la release, sachez qu'elle ne se fera pas sans que la doc soit complète, vous pouvez donc faire avancer le schmilblick vous aussi ;)

Ce blog a déménagé

Kozlika — Wed, 10 Jan 2007 16:01:00 +0100

Pour ne pas encombrer le serveur de mon petit camarade, j'ai déménagé ce blog dont l'url sera désormais http://dissitou.klafoutis.org/

J'ai mis une redirection mais pensez tout de même à modifier vos éventuels marque-page et abonnements !

Ah tiens au fait, rien de plus simple que cette redirection. Dans le fichier htaccess placé à la racine de l'espace web de kozlika.org il m'a suffi d'ajouter :

RedirectMatch permanent /dissitou/(.*) http://dissitou.klafoutis.org/$1

Aorakits : 3. Un blog de test

Kozlika — Tue, 09 Jan 2007 17:40:00 +0100

L'un des avantages du multiblog c'est de pouvoir faire plusieurs blogs (wi wi, LaPalisse est mon cousin).

Il serait dommage de ne pas en profiter pour créer à côté de votre blog public un petit blog dont l'adresse ne sera connue que de vous et ceux auxquels vous l'aurez donnée afin de vous y livrer en toute tranquillité à vos divers essais de laboratoire, notamment la réalisation ou la modification de vos thèmes.

Un petit assortiment de billets de tous ordres, avec ou sans extrait, avec ou sans tags, avec ou sans catégories, avec des images grandes ou petites, flottantes ou non, des billets courts et des billets longs, des titres à rallonge ou des titres courts... et le fameux billet de test avec toutes les balises wiki in situ.

Ah wuais mais faut les écrire, et vous avez la flemme. Je comprends ça, je suis moi-même la reine des feignasses. Mais si on vous livrait un fichier de sauvegarde tout prêt à importer dans votre blog-labo hein ?

Hop !

Télécharger le fichier en pièce jointe sur votre ordinateur
Blogs -> Nouveau blog > toukivabien dans la config du nouveau blog
Import/Export -> Charger un fichier de sauvegarde <le fichier que vous venez de télécharger>
Et oualu. Il vous reste à insérer des images dans les billets tagués images (la maison ne les fournit pas), votre blog de test est prêt.

dcTips() - Trucs divers

Clearbricks : quelques autres fonctions de dbLayer

La table lecteurs

Le curseur

Insérer un enregistrement avec la fonction insert()

Modifier un enregistrement avec la fonction update()

Effacer un enregistrement avec la fonction execute()

Quelques fonctions supplémentaires pour les recordsets

isEmpty()

count()

Conclusion

Clearbricks : découverte de dbLayer et de sa fonction select()

Introduction à Clearbricks

La base de données

La classe dbLayer

La table lecteurs

Première requête sur un enregistrement et un champ

Une requête sur un champ avec plusieurs enregistrements

Une requête sur plusieurs champs de plusieurs enregistrements

Conclusion

Notes

Fermeture pendant les travaux

Bonjour, c'est pour un sondage...

Total Validator

Apportez votre pierre à l'édifice !

Ce blog a déménagé

Aorakits : 3. Un blog de test

Insérer un enregistrement avec la fonction `insert()`

Modifier un enregistrement avec la fonction `update()`

Effacer un enregistrement avec la fonction `execute()`

`isEmpty()`

`count()`