Utilisation de l'API IMu

Le bundle de code source de l’API IMu pour la version 2.0 (ou supérieure) est nécessaire pour développer une application basée sur IMu. Ce bundle contient toutes les classes qui composent l’API IMu PHP. Contactez l’assistance Axiell pour obtenir l’accès aux bundles de l’API IMu.

Pour construire des applications web PHP (l’utilisation la plus courante de l’API PHP IMu), le bundle de code source doit être extrait sur la machine serveur web et être accessible par le serveur web.

Pour utiliser l’API PHP IMu, incluez IMu.php dans le code PHP. Par exemple, si le code source de l’API IMu est installé dans le répertoire /usr/local/lib/imu, les lignes suivantes seront ajoutées au code PHP :

Le fichier IMu.php définit la classe IMu. Cette classe comprend les membres statiques qui contiennent des informations sur l’installation de l’IMu. La classe comprend :

• IMu::$lib - le chemin d’accès aux fichiers API PHP de l’IMu.
• IMu::VERSION - la version de cette distribution d’IMu.

Le membre $lib doit également être utilisé pour simplifier l’inclusion d’autres fichiers de bibliothèque IMu, par exemple :

 <?php require_once IMu::$lib . '/Session.php'; ?> 

Programme de test

La création de cette page web très simple basée sur IMu constitue un bon test pour vérifier si l’environnement de développement a été correctement configuré pour utiliser IMu :

 <?php require_once '/usr/local/lib/imu/IMu.php';  printf('IMu version %s', IMu::VERSION); exit(0); ?> 

Exceptions

De nombreuses méthodes des objets de la bibliothèque IMu lèvent une exception lorsqu’une erreur se produit. Pour cette raison, le code qui utilise des objets de bibliothèque IMu doit être entouré d’un bloc try / catch.

Le code suivant est un modèle de base pour écrire des programmes PHP qui utilisent la bibliothèque IMu :

 <?php require_once '/usr/local/lib/imu/IMu.php'; // ⋯ try { /* Créer et utiliser des objets IMu * ⋯ */ } catch(Exception $e) { /* Gérer ou signaler l'erreur * ⋯ */ } ?> 

La plupart des exceptions IMu lèvent un objet IMuException. La classe IMuException est une sous-classe de la classe standard Exception de PHP. Dans de nombreux cas, votre code peut simplement intercepter l’exception standard Exception (comme dans ce modèle). Si davantage d’informations sont nécessaires au sujet de l’exception IMuException exacte qui a été levée, consultez la rubrique Exceptions.

Note: La plupart des exemples qui suivent supposent que les fragments de code sont entourés de code structuré de cette manière.