ConFoo 2025

bindtextdomain

(PHP 4, PHP 5, PHP 7, PHP 8)

bindtextdomainSpécifie ou récupère le chemin d'un domaine

Description

bindtextdomain(string $domain, ?string $directory = null): string|false

La fonction bindtextdomain() défini ou récupère le chemin d'un domaine.

Liste de paramètres

domain

Le domaine.

directory

Le chemin vers le dossier. Une chaîne vide signifie le dossier courant. Si null, le dossier actuellement défini est retourné.

Valeurs de retour

Le chemin complet pour le domain actuellement défini, ou false si une erreur survient.

Historique

Version Description
8.4.0 directory est désormais facultatif. Auparavant, ce paramètre devait toujours être spécifié.
8.0.3 directory est désormais nullable. Auparavant, il n'était pas possible de récupérer le dossier actuellement défini.

Exemples

Exemple #1 Exemple avec bindtextdomain()

<?php

$domain
= 'myapp';
echo
bindtextdomain($domain, '/usr/share/myapp/locale');

?>

L'exemple ci-dessus va afficher :

/usr/share/myapp/locale

Notes

Note:

L'information bindtextdomain() est maintenue par process, et non par thread.

add a note

User Contributed Notes 2 notes

up
6
n8klatt
10 years ago
The name of your .mo file must match the $domain, e.g. name your files messages.mo and call bindtextdomain("messages", $directory).
up
4
roel dot vermeulen at gmail dot com
8 years ago
I recommend using absolute paths in the $directory parameter. This caused me several hours to debug as Ajax calls to my localization functions messed up the path. And since no error if thrown if the path in $directory cannot be found, one should check the result always:

<?php
// Imagine the path for this file is "/localization" and your locales are in the "/locale" directory.
$pathToDomain = __DIR__ . "/../locale";
if (
$pathToDomain != bindtextdomain($domain, $pathToDomain)) {
// Error handling.
}
?>
To Top