Jeromecold DB
Jeromecold DB, est un outil conçu pour donner à un serveur PHP simple, un système de gestion de bases de données entièrement en PHP. Sur un vieux serveur par exemple, ou sur un serveur n'exécutant pas Mysql, il permettra aux utilisateurs de créer des bases de données facilement, ainsi que les lire, les modifier, les supprimer... Comme de vraies bases mais sans Mysql!Informations:
| Version: | 2.0 |
| Minimum de configuration requise: | PHP 5, espace disque en fonction de l'emploi |
| Licence: | Gratuit pour un usage non-commercial |
| Type de script: | Gestionnaire de bases de données |
| Téléchargement: | Cliquez ici (rar) |
| Anciennes versions: | 1 bêta - 1.1 bêta - 1.2 bêta |
| Etat d'avancement de la future version: |  |
Mode d'emploi
FonctionsVoici la liste des fonctions héritées de la
version 1, elles peuvent toujours êtres
utilisées de la même façon avec la version
2 à l'exception de la fonction
count_base().
Notez qu'il vaut cependant mieux utiliser
le JDBQL pour faire ses requêtes, elles seront
également plus complètes.
| Fonction (sans mise à la ligne) | Emploi |
| create_db(nom) | Création d'une base de données nommé "nom". |
| insert_champ (base,nom,valeur) | Insert un champ dans une base de données nommé "base" de nom "nom" et de valeur "valeur". |
| update_champ (base,nom,valeur) | Modifie la valeur "valeur" du champ "nom" dans la base de données "base" |
| read_champ (base, nom) | Renvois le contenu du champ "nom" dans la base "base". |
| delete_champ (base,champ) | Supprime le champ "champ" de la base "base". |
| delete_base (base) | Supprime la base nommée "base" et tout son contenu. |
| over_read_champ (base,champ) | Force la lecture intégrale du champ "champ" dans la base "base". |
| credits() | Renvois un array contenant les informations techniques de Jeromecold DB. |
| jdb_query() | Permet de soumettre une requête en JDBQL (version 2.0+) |
JDBQL
Le JDBQL est un langage dérivé du SQL, adapté pour JDB. Il utilise pour cela la fonction jdb_query().
Pour en savoir plus sur l'utilisation du JDBQL, reportez-vous à la documentation officielle ci-dessous:
Evidemment pour profiter de ces fonctions, il faut inclure le fichier "jeromecold_db.php" dans vos scripts. Le fichier "databases" doit être dans le même dossier que le script exécutant des requêtes. Si ce n'est pas le cas, indiquez le chemin relatif vers le dossier "databases" dans la variable $jdb_path AVANT d'inclure JDB dans votre projet!
Exemples d'utilisation:
Compteur de visites:Pour JDB 1 et + en utilisant les fonctions JDB:
<?php
include("jeromecold_db.php");
// Dans une base nommée "compteur", le champs "total" contient le nombre de visites
$ancienne_valeur = read_champ("compteur", "total");
$nouvelle_valeur = $ancienne_valeur++;
update_champ("compteur", "total", $nouvelle_valeur);
echo read_champ("compteur", "total");
?>
include("jeromecold_db.php");
// Dans une base nommée "compteur", le champs "total" contient le nombre de visites
$ancienne_valeur = read_champ("compteur", "total");
$nouvelle_valeur = $ancienne_valeur++;
update_champ("compteur", "total", $nouvelle_valeur);
echo read_champ("compteur", "total");
?>
Pour JDB 2 en utilisant le JDBQL:
<?php
include("jeromecold_db.php");
// Dans la base "'compteur", le champ "total" contient la valeur du compteur
jdb_query("UPDATE champ NAME total IN base NAME compteur VALUE JDB:OLDVALUE + 1"); // On incrémente de 1 l'ancienne valeur
echo jdb_query("READ IN base NAME compteur ID total");
?>
include("jeromecold_db.php");
// Dans la base "'compteur", le champ "total" contient la valeur du compteur
jdb_query("UPDATE champ NAME total IN base NAME compteur VALUE JDB:OLDVALUE + 1"); // On incrémente de 1 l'ancienne valeur
echo jdb_query("READ IN base NAME compteur ID total");
?>
Migrer de JDB 1.x à JDB 2.x
JDB 1 et JDB 2 fonctionnent sur la même architecture, cependant, JDB 2 a besoin en plus d'un fichier dans lequel il placera sont système de gestion des ID pour chaque base.Si vous migrez de JDB 1 vers JDB 2, il vous faudra créer ce fichier dans chaque base, pour cela, utilisez cette requete:
jdb_query("BUILD index IN base NAME ******");
Remplacez ******* par le nom de la base à migrer; les valeurs de vos champs et leurs nom ne seront pas affectés par ce changement.
Notez que JDB 2 est rétro-compatible avec JDB 1, un script créé pour JDB 1 fonctionnera avec JDB 2 (après migration de la base). Vous pourrez au besoin remettre JDB 1 sans que cela affecte vos bases de données.
Changelog:
De la version 1.2b à la version 2.0:- Gestion du JDBQL pour les requêtes,
- Ajout d'un stress mode et d'un fichier log pour les erreurs (à configurer dans le fichier jeromecold_db.php),
- Ajout d'un système de gestion des ID,
- Optimisation des requêtes,
- Ajout des fonctions jdb_log_register() et jdb_query().
De la version 1.1b à la version 1.2b:
- Correction du bogue sur la fonction delete_base qui renvoyait TRUE sans avoir supprimé la base.
De la version 1b à la version 1.1b:
- Gestion des valeurs booléennes,
- Optimisation de la lecture pour toutes les fonctions; over_read_champ(); n'est à utiliser que si read_champ(); ne fonctionne pas,
- Suppression des messages d'erreur, utilisez les valeurs booléennes pour les détecter.
