Connexion à un serveur IMu

La plupart des programmes basés sur IMu commencent par créer une connexion à un serveur IMu. Les connexions à un serveur sont créées et gérées à l’aide de la classe IMuSession de l’IMu. Avant de se connecter, le nom de l’hôte et le numéro de port auquel se connecter doivent être spécifiés. Cela peut se faire de trois manières.

La façon la plus simple de créer une connexion à un serveur IMu est de passer le nom d’hôte et le numéro de port au constructeur IMuSession, puis d’appeler la méthode connect. Par exemple :
```
require_once '/usr/local/lib/imu/IMu.php'; require_once IMu::$lib . '/Session.php'; // ⋯ $session = new IMuSession('server.com', 12345); $session->connect(); 
```

Vous pouvez également ne transmettre aucune valeur au constructeur, puis définir les propriétés host et port (à l’aide des méthodes setHost et setPort) avant d’appeler connect :

require_once '/usr/local/lib/imu/IMu.php' ;  require_once IMu ::$lib . '/Session.php' ;  // ⋯ $session = new IMuSession() ;  $session->setHost("server.com") ;  $session->setPort(12345) ; $session->connect() ;

Si l’hôte ou le port n’est pas défini, la valeur par défaut de la classe IMuSession sera utilisée. Ces valeurs par défaut peuvent être remplacées en définissant les propriétés de classe (statiques) defaultHost et defaultPort :
```
require_once '/usr/local/lib/imu/IMu.php' ; require_once IMu ::$lib . '/Session.php' ; // ⋯ IMuSession ::setDefaultHost('server.com') ; IMuSession ::setDefaultPort(12345) ; $session = new IMuSession() ;  $session->connect() ; 
```
Cette technique est utile lorsque vous prévoyez de créer plusieurs connexions au même serveur ou lorsque vous souhaitez qu’un objet Handler établisse automatiquement la connexion.

Handlers

Une fois qu’une connexion à un serveur IMu a été établie, il est possible de créer des objets handler pour soumettre des requêtes au serveur et recevoir des réponses.

Note: Lorsqu’un objet handler est créé, un objet correspondant est créé par le serveur IMu pour traiter les requêtes du handler.

Tous les handlers sont des sous-classes de la classe IMuHandler d’IMu.

Note: Vous ne créez généralement pas un objet IMuHandler directement, mais utilisez plutôt une sous-classe.

Dans ce document, nous examinons le handler le plus fréquemment utilisé, IMuModule, qui vous permet de trouver et de récupérer des enregistrements à partir d’un seul module EMu.