BINDTEXTDOMAIN |
Liaison avec un domaine texte |
| PHP 4.0+ |
Extension GETTEXT |
Syntaxe
|
function bindtextdomain($domain, $directory);
|
Paramètres
| Nom |
Description |
| $domain |
Ce paramètre permet d'indiquer le nom de domaine. |
| $directory |
Ce paramètre permet d'indiquer le répertoire. |
Retour
| Valeur |
Description |
| chaîne de caractères |
Ces valeurs permettent d'indiquer un chemin complet vers le répertoire. |
Description
Cette fonction permet de fixer le chemin associé avec un nom de domaine.
Remarques
- Définition du répertoire des fichiers de traduction : La fonction bindtextdomain est utilisée pour définir le répertoire dans lequel PHP recherchera
les fichiers de traduction (souvent des fichiers .mo ou .po). Ces fichiers sont essentiels pour les applications multilingues, permettant d'afficher des messages
dans différentes langues.
- Lien avec les variables d'environnement : Cette fonction fonctionne en tandem avec les fonctions de localisation comme gettext et textdomain. Une
fois le répertoire défini avec bindtextdomain, PHP peut récupérer les traductions correspondant à la langue ou au domaine actif, ce qui est crucial pour
l'internationalisation des applications.
- Utilisation de domaines : Un domaine est une sorte de catégorie ou de groupe de messages de traduction. bindtextdomain permet d'associer un domaine
spécifique à un répertoire. Cela signifie que différentes parties d'une application peuvent avoir leurs propres traductions, organisées dans des sous-répertoires distincts.
- Paramètre du répertoire : Le premier paramètre de bindtextdomain est le domaine de traduction, et le deuxième est le répertoire où se trouvent les fichiers
.mo. Si ce répertoire est incorrect ou inaccessible, les traductions risquent de ne pas être trouvées, ce qui empêche le bon affichage des messages localisés.
- Retour de la fonction : Lorsque la fonction bindtextdomain est appelée, elle retourne le répertoire ayant été défini pour le domaine de traduction. Cela
permet de vérifier si la configuration a été effectuée correctement ou si le chemin du répertoire est valide.
- Comportement par défaut : Si aucun répertoire n'est spécifié, PHP utilise un répertoire par défaut pour chercher les fichiers de traduction, ce qui peut ne pas
être adapté dans tous les cas. Pour une organisation précise et propre des fichiers de traduction, il est donc essentiel de spécifier explicitement le répertoire avec cette
fonction.
- Importance dans les applications multilingues : Lorsqu'une application doit supporter plusieurs langues, l'utilisation de bindtextdomain permet de rendre
le système de traduction plus flexible et plus simple à maintenir. Les fichiers de traduction peuvent être séparés et organisés de manière efficace pour chaque langue ou domaine
spécifique.
- Dépendance sur les locales du système : La fonction bindtextdomain repose souvent sur les paramètres régionaux du système d'exploitation (locales). Si les
locales ne sont pas configurées correctement sur le serveur ou l'environnement d'exécution, cela peut empêcher la récupération des traductions appropriées, rendant l'application
inintelligible pour certains utilisateurs.
Voir également
Langage de programmation - PHP - Référence de procédures et fonctions - dcgettext
Langage de programmation - PHP - Référence de procédures et fonctions - dgettext
Dernière mise à jour : Mercredi, le 25 mars 2015