Manuel utilisateur
Version 1.9 — Rev. 3

# Modeles de virtual hosts

Les modeles de virtual hosts facilitent la creation de nombreux nouveaux virtual hosts avec des configurations similaires.
Chaque modele contient un fichier de configuration de modele, une liste de listeners mappes et une liste de virtual hosts membres.
Pour ajouter un virtual host base sur un modele, l'administrateur doit seulement ajouter un membre avec un nom de virtual host unique et un nom de domaine qualifie a la liste des membres du modele. Le mappage listener-vers-virtual host sera ajoute automatiquement pour tous les listeners de la liste des listeners mappes du modele.
Plus tard, si vous devez personnaliser la configuration d'un virtual host particulier, il suffit d'"instancier" ce virtual host membre et une configuration de virtual host autonome sera creee automatiquement. Meme lors de la configuration d'un virtual host personnalise, un modele peut rester un point de depart pratique.

### Nom de la template

#### Description

Nom unique de la template.

### Fichier de template

#### Description

Indique le chemin du fichier de configuration de cette template. Le fichier doit se trouver dans $SERVER_ROOT/conf/templates/ avec un nom de fichier ".conf". Si le fichier désigné n'existe pas, après une tentative d'enregistrement de la template, une erreur apparaîtra avec le lien "CLICK TO CREATE". Ce lien générera un nouveau fichier de template vide. Lorsque vous supprimez la template, l'entrée est retirée de vos configurations, mais le fichier de configuration réel de la template n'est pas supprimé.

#### Syntaxe

chemin

### Listeners mappés

#### Description

Indique les noms de tous les listeners auxquels cette template est mappée. Un mappage listener vers hôte virtuel pour les hôtes virtuels membres de cette template sera ajouté aux listeners indiqués dans ce champ. Ce mappage associera les listeners aux hôtes virtuels selon les noms de domaine et les alias définis dans les configurations individuelles des hôtes virtuels membres.

#### Syntaxe

liste séparée par des virgules

### Nom de l'hôte virtuel

#### Description

Nom unique de cet hôte virtuel. Ce nom doit être unique parmi tous les hôtes virtuels membres de template et les hôtes virtuels autonomes. Dans une configuration de chemin de répertoire, ce nom peut être référencé par la variable $VH_NAME.
Si un hôte virtuel autonome portant le même nom est également configuré, la configuration de l'hôte virtuel membre sera ignorée.

### Nom de domaine

#### Description

Indique le nom de domaine principal de cet hôte virtuel membre. S'il est laissé vide, le nom de l'hôte virtuel sera utilisé. Il doit s'agir d'un nom de domaine pleinement qualifié, mais vous pouvez également utiliser une adresse IP. Il est recommandé d'ajouter :<port> pour les sites web qui ne sont pas sur le port 80. Pour les configurations contenant des noms de domaine, ce domaine peut être référencé avec la variable $VH_DOMAIN.
Ce nom de domaine sera utilisé dans les situations suivantes:

1. Pour faire correspondre le hostname dans l'en-tête Host lors du traitement d'une requête.
2. Pour remplir les configurations de noms de domaine pour des modules complémentaires comme FrontPage ou AWstats.
3. Pour configurer les mappages listener vers hôte virtuel basés sur la template d'hôte virtuel.

#### Syntaxe

nom de domaine

### Alias de domaine

#### Description

Indique les autres noms de l'hôte virtuel. Tous les hostnames et adresses IP possibles doivent être ajoutés à cette liste. Les caractères génériques * et ? sont autorisés dans le nom. Ajoutez :<port> pour les sites web qui ne sont pas sur le port 80.
Les alias seront utilisés dans les situations suivantes:

1. Pour faire correspondre le hostname dans l'en-tête Host lors du traitement d'une requête.
2. Pour remplir les configurations de nom de domaine/alias pour des modules complémentaires comme FrontPage ou AWstats.
3. Pour configurer les mappages listener vers hôte virtuel basés sur la template d'hôte virtuel.

#### Syntaxe

Liste de noms de domaine séparés par des virgules.

### Racine de l'hôte virtuel membre

#### Description

Indique le répertoire racine de cet hôte virtuel. S'il est laissé vide, la racine d'hôte virtuel par défaut de cette template sera utilisée.
Remarque: ce n'est PAS la racine des documents. Il est recommandé de placer tous les fichiers liés à l'hôte virtuel (comme la configuration de l'hôte virtuel, les fichiers journaux, les fichiers html, les scripts CGI, etc.) sous ce répertoire. La racine de l'hôte virtuel peut être référencée comme $VH_ROOT.

#### Syntaxe

chemin

### Racine d'hôte virtuel par défaut

#### Description

Indique le répertoire racine par défaut pour les hôtes virtuels membres utilisant cette template. La variable $VH_NAME doit apparaître dans le chemin. Cela permet d'attribuer automatiquement à chaque membre de la template un répertoire racine distinct basé sur son nom.

#### Syntaxe

chemin

### Fichier de configuration VHost instancié

#### Description

Indique l'emplacement du fichier de configuration généré lorsque vous instanciez un hôte virtuel membre. La variable $VH_NAME doit apparaître dans le chemin afin que chaque hôte virtuel ait son propre fichier. Il doit se trouver sous $SERVER_ROOT/conf/vhosts/. Ce fichier de configuration ne sera créé qu'après avoir sorti un vhost membre de la template par instanciation.

#### Syntaxe

Chaîne avec la variable $VH_NAME et le suffixe .conf

#### Conseils

Information $VH_NAME/vhconf.conf est recommandé pour faciliter la gestion.

### Racine des documents

#### Description

Indique le chemin unique de la racine des documents de chaque hôte virtuel membre. La variable $VH_NAME ou $VH_ROOT doit apparaître dans le chemin afin que chaque hôte virtuel membre ait sa propre racine des documents.

#### Syntaxe

chemin avec la variable $VH_NAME ou $VH_ROOT

#### Exemple

$VH_ROOT/public_html/ ou $SERVER_ROOT/$VH_NAME/public_html.

### Nom de fichier utilisé dans la template

#### Description

Indique un chemin de fichier utilisé par les réglages d'hôtes virtuels basés sur une template. La variable $VH_NAME ou $VH_ROOT doit apparaître dans le chemin afin que chaque hôte virtuel membre pointe vers son propre fichier. Ce réglage concerne les fichiers appartenant à la template, comme les fichiers journaux, et non le fichier de configuration VHost instancié.

#### Syntaxe

chemin avec la variable $VH_NAME ou $VH_ROOT