bindtextdomain

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

    bindtextdomain — ドメインのパスを取得/設定する

    説明

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

    bindtextdomain() 関数は、ドメインへのパスを取得/設定します。

    パラメータ

    domain

    ドメイン。

    directory

    ディレクトリのパス。 空文字列を指定すると、現在のディレクトリを指定したことになります。 null を指定すると、現在設定されているディレクトリが返されます。

    戻り値

    現在設定されているドメインへのフルパスを返します。 失敗した場合に false を返します

    変更履歴

    バージョン 説明
    8.4.0 directory パラメータが任意になりました。 これより前のバージョンでは、常に指定しなければなりませんでした。
    8.0.3 directory は、nullable になりました。 これより前のバージョンでは、現在設定されているディレクトリを取得できませんでした。

    例

    例1 bindtextdomain() の例

    <?php

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

    ?>

    上の例の出力は以下となります。

    /usr/share/myapp/locale

    注意

    注意:

    bindtextdomain() 関数の情報はプロセス単位で管理されます。 スレッドではありません。

    Found A Problem?

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

    User Contributed Notes 2 notes

    up
    5
    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.    }?>
    up
    4
    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
    To Top