bindtextdomain

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

bindtextdomain — Spécifie ou récupère le chemin d'un domaine

Description

bindtextdomain(string $domain, ?string $directory): 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.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.

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

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.
    }
?>

down

n8klatt ¶

9 years ago

The name of your .mo file must match the $domain, e.g. name your files messages.mo and call bindtextdomain("messages", $directory).

＋add a note