Hostname
Zend_Validate_Hostname vous permet de valider un nom de domaine sur la base d'un ensemble de
spécifications connues. Il est ainsi possible de valider trois types différents de noms de domaine : un nom de
domaine qualifié (ex : domaine.com), une adresse IP (ex : 1.2.3.4) ou un nom de domaine local (ex : localhost). Par
défaut, seul les noms de domaine qualifiés sont acceptés.
Utilisation basique
Exemple simple : isValid($domaine)) {
// le nom de domaine est valide
} else {
// le nom de domaine est invalide ; afficher pourquoi
foreach ($validateur->getMessages() as $message) {
echo "$message\n";
}
}
]]> Ceci validera le domaine $domaine et, en cas d'échec, fournira des messages d'erreur
informatifs via $validator->getMessages().
Validation de différents types de noms de domaine
Il peut se trouver que vous souhaitez valider des adresses IP, des noms de domaine locaux ou toute combinaison
de tous les types disponibles. Cette opération peut être effectuée en passant un paramètre à
Zend_Validate_Hostname au moment de l'instanciation. Le paramètre doit être un entier qui détermine
quels types de noms de domaine sont admis. Il est recommandé d'utiliser les constantes de la classe
Zend_Validate_Hostname.
Les constantes de Zend_Validate_Hostname sont : ALLOW_DNS qui autorise uniquement
les noms de domaine qualifiés, ALLOW_IP qui autorise les adresses IP, ALLOW_LOCAL qui
autorise les domaines locaux et ALLOW_ALL qui autorise les trois types précédents. Pour vérifier
uniquement les adresses IP, vous pouvez utiliser l'exemple suivant : isValid($hostname)) {
// le nom de domaine est valide
} else {
// le nom de domaine est invalide ; afficher pourquoi
foreach ($validateur->getMessages() as $message) {
echo "$message\n";
}
}
]]>
Vous pouvez utiliser ALLOW_ALL pour accepter tous les types de domaines. De même, vous pouvez
créer des configurations combinant ces différents types. Par exemple, pour accepter les domaines qualifiés et les
domaines locaux, instanciez votre objet Zend_Validate_Hostname de la manière suivante :
Validation de Nom de Domaine International (IDN)
Certains noms de domaines nationaux (Country Code Top Level Domains ou ccTLD), comme .de (Allemagne), supporte
les caractères internationaux dans leurs noms de domaine. Ceci est connu sous le nom de Nom de Domaine International
(IDN). Ces domaines peuvent être vérifiés par Zend_Validate_Hostname grâce aux caractères étendus qui
sont utilisés dans le processus de validation.
Pour l'instant, la liste des ccTLD supportés inclus :
at (Autriche)
ch (Suisse)
li (Liechtenstein)
de (Allemagne)
fi (Finlande)
hu (Hongrie)
no (Norvège)
se (Suède)
Pour vérifier un domaine IDN c'est aussi simple que d'utiliser le validateur standard de nom de domaine
puisque la validation IDN est activé par défaut. Si vous voulez mettre hors service la validation IDN, cela peut
être fait par le passage d'un paramètre au constructeur Zend_Validate_Hostname ou via la méthode
$validator->setValidateIdn().
Vous pouvez aussi désactiver la validation IDN en passant un second paramètre au constructeur du
Zend_Validate_Hostname comme ceci :
Alternativement vous pouvez passer soit true soit false à
$validator->setValidateIdn() pour activer ou désactiver la validation IDN. Si vous essayez de
vérifier un nom de domaine IDN qui n'est pas actuellement soutenu il est probable qu'il retournera une erreur s'il y
a des caractères internationaux. Quand un fichier de ccTLD spécifiant les caractères supplémentaires n'existe pas
dans "Zend/Validate/Hostname",une validation de nom de domaine normale est réalisée.
Notez cependant que les IDNs sont seulement validés si vous autorisez la validation des noms de
domaine.
Validation des "Top Level Domains"
Par défaut un nom de domaine sera vérifié grâce à une liste de TLDs connus. Si cette fonctionnalité n'est pas
nécessaire, elle peut être désactivée de la même façon que la désactivation du support des IDNs. Vous pouvez
désactiver la validation TLD en passant un troisième paramètre au constructeur de
Zend_Validate_Hostname. Dans l'exemple ci-dessous, la validation IDN est supportée via le second
paramètre.
Alternativement vous pouvez passer soit true soit false à
$validator->setValidateTld() pour activer ou désactiver la validation TLD.
Notez cependant que les TLDs sont seulement validés si vous autorisez la validation des noms de
domaine.