Grande nouveauté de la version 1.0.0 BETA2 de FSB, les requètes de cache. Ces requètes sont simplement un outil permettants :
1) De pouvoir facilement effectuer des actions sur des fichiers du cache
2) De permettre un accès immédiat aux fichiers cache sans passer par ceux ci.

Leur utilité est fait notament pour les fichiers d'installation des MODS et pour les mises à jour. Ainsi vous n'êtes (vous moddeurs) jamais censé en théorie ouvrir un fichier du cache dans votre installation du MOD. Voici la syntaxe des différentes requètes disponibles.

ATTENTION, les requètes sont sensibles à la casse. SELECT est une commande bonne mais select ne l'est pas.

[size=18]CREATE[/size]

Cette commande permet de créer automatiquement un nouveau fichier du cache avec une structure de tableau :

Code (Sélectionner le code)

CREATE table champs1 champs2 ... champsN


Le second argument "table" est le nom du tableau qui sera créé, le nom du fichier sera cache/fichier_table.php. Ensuite vous pouvez ajouter nautant de champs que vous souhaitez à votre tableau. Notez que cette commande requiert que le dossier cache/ soit CHMODer en 0777

[size=18]ALTER[/size]

Cette commande permet de modifier la structure d'un tableau, voici sa syntaxe :

Code (Sélectionner le code)

ALTER table [[ADD champs [DEFAULT value][DROP champs]]


L'argument ADD va ajouter un champs. Si vous souhaitez donner une valeur directeent à tous ces champs utilisez DEFAULT enssuite.
L'argument DROP va supprimer un champs du tableau.
Voici une sérieu d'exemples :

Code (Sélectionner le code)

ALTER forum ADD un_champ;
ALTER forum DROP un_champ;

ALTER forum ADD un_champ DEFAULT value;
ALTER forum ADD un_champ2 DROP un_champ DROP un_champ2;

[size=18]INSERT[/size]

Cette commande permet d'insérer une nouvelle ligne dans un tableau du cache. Elle prend un argument optionel FIELDS. Si cet argument est donné vous pouvez choisir les champs qui seront affectés par le INSERT (les autres champs auront une valeur ''). Si vous ne donnez pas de FIELDS vous devez préciser autant de valeur qu'il y a de champs dans VALUES.
Prenons par exemple une table avec 4 champs (1, 2, 3, 4) :

Code (Sélectionner le code)

INSERT table FIELDS 1 3 VALUES value1 value3;
INSERT table VALUES value1 value2 value3 value4;

[size=18]UPDATE[/size]

Cette commande met à jour des champs d'une ou plusieurs lignes. Voici la syntaxe :

Code (Sélectionner le code)

UPDATE table champs1 value1 champs2 value2 ... champsN valueN [WHERE champs value]


La clause WHERE n'est pas obligatoire, prenons des exemples :

Code (Sélectionner le code)

UPDATE forum forum_nom 'un nouveau nom a mon forum' forum_description 'Une nouvelle description' WHERE forum_id 1 3


Va assigner ces valeurs aux champs des forums dont l'ID est 1 ou 3. Si vous ommettez la clause WHERE toutes les lignes seront affectées.

----- A partir d'ici les requètes ne devrait pas vous servir pour les fichiers d'install ------------

[size=18]DELETE[/size]

Cette commande supprime les lignes indiqués, voici sa syntaxe :

Code (Sélectionner le code)

DELETE table WHERE champ condition ... conditionN


Voici un exemple :

Code (Sélectionner le code)

DELETE forum WHERE forum_id 1 3 5;

[size=18]DROP[/size]

Cette commande supprime les fichiers caches donnés (à utiliser avec prudence) :

Code (Sélectionner le code)

DROP fichier1 fichier2 ... fichierN

[size=18]SELECT[/size]

Cette commande selectionne des données (utilisez cette commande depuis le panneau d'administration vous montrera les données sellectionnés :

Code (Sélectionner le code)

SELECT table champs1 champs2 ... champsN [WHERE champs condition]


La clause WHERE n'est pas obligatoire, voici des exemples :

Code (Sélectionner le code)

SELECT forum forum_id forum_nom forum_description WHERE cat_id 1 2;
SELECT forum *

[size=18]BACKUP[/size]

Cette commande selectionne des données sur les fichiers cache passés en argument. Elle dispose de trois flags : DATA (selelection les données), STRUCT (selectionne la structure) et DATASTRUCT (selection données et structures). Par exemple :

Code (Sélectionner le code)

BACKUP DATA categorie forum smiley;
BACKUP STRUCTDATA forum

----- Quelques trucs et astuces ----------------

1) Vous pouvez utiliser les ' ' autour d'une valeur pour la préserver des espaces, par exemple :


2) N'utilisez pas les requètes de cahce dans vos programmes en plein sur le forum, en théorie elle seront aussi lente (voire plus) qu'une requète SQL. Pour préserver la rapidité manipulez directement les tableaux.

3) La classe implémente des fonctions qui peuvent vous servir (dans des fichiers de mise à jour par exemple), ou dans des cas précis :


Pour toute question, optimisation ou autre n'hésitez pas (sur le forum).