bindtextdomain

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

bindtextdomain — Sets or gets the path for a domain

Descrizione

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

The bindtextdomain() function sets or gets the path for a domain.

Elenco dei parametri

domain: The domain.
directory: The directory path. An empty string means the current directory. If null, the currently set directory is returned.

Valori restituiti

The full pathname for the domain currently being set, o false in caso di fallimento.

Log delle modifiche

Versione	Descrizione
8.4.0	`directory` is optional now. Previously, the parameter always had to be specified.
8.0.3	`directory` is nullable now. Previously, it was not possible to retrieve the currently set directory.

Esempi

Example #1 bindtextdomain() example

<?php

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

?>

Il precedente esempio visualizzerà:

/usr/share/myapp/locale

Note

Nota:
The bindtextdomain() information is maintained per process, not per thread.

Found A Problem?

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 ¶

9 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 ¶

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).

＋add a note