Accueil | Tutoriels | Téléchargement | A propos

2) Initiation à Xhordes

Bien à ce stade vous devriez avoir un dossier "libs" dans le dossier de votre site contenant toutes les classes de XH.
Nous allons commencer par créer une nouvelle page afin d'y tester les codes exemples.

Il faut avant tout inclure tous les fichiers des classes : include_once 'libs/main.class.php';
include_once 'libs/error.class.php';
include_once 'libs/headers.class.php';
include_once 'libs/city.class.php';
include_once 'libs/bank.class.php';
include_once 'libs/expeditions.class.php';
include_once 'libs/citizens.class.php';
include_once 'libs/cadavers.class.php';
include_once 'libs/map.class.php';
include_once 'libs/upgrades.class.php';
include_once 'libs/estimations.class.php';
Si vous avez déjà vu le contenu du flux XML, vous retrouvez ici chaques noeuds divisés en classes, chacunes dans un fichier différent.

Après avoir inclus toutes les classes, on peut maintenant créer l'instance de la classe principale :
$main = new Main($cle_api); Alors voici la déclaration de la classe Main, qui gère toutes les autres classes.
Main prend un paramètre obligatoire : la clé api du flux XMl à récupérer, je vous conseille de mettre votre clé.
Cela était le minimum pour instancier la classe Main mais il faut savoir qu'il existe 3 autres paramètres qui sont facultatifs :
$main = new Main($cle_api, $activation, $libs, $debug);

• $activation permet de ne charger que certaines classes afin d'alléger le chargement de Main, par défaut, toutes les autres classes sont chargées.
  Ce paramètre prend 2 sortes de valeurs :
  - 'all' qui permet de charger toutes les classes.
  - Un array avec le nom des classes à chargés.
  Exemple :
  array('citizens', 'map', 'expeditions')
• $libs : ca permet de définir le dossier où se trouve toutes les classes, par défaut, ce paramètre vaut 'libs/'.
• $debug : comme son nom l'indique, ce paramètre est activé pour un mode de débug, ca affiche des messages pendant l'éxécution de la classe, notament, les classes chargées et les données récupérées.
  Ce paramètre est un booléen (true ou false).

Bien cette partie touche à sa fin, dans la prochaine partie, vous apprendrez comment récupérer les données du flux XML.
Un dernier mot, vous pouvez essayer d'utiliser les classes sans passer par Main, l'avantage était de ne charger que les classes nécessaires mais c'est désormais possible par le Main, personnelement je n'y vois pas d'utilité mais c'est logiquement possible ;) .

Précédent - Qu'est ce que Xhordes ? Téléchargement et installation - Suivant - Comment récupérés des données ?

.