bindtextdomain

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

説明

stringfalse bindtextdomain(string $domain, stringnull $directory = null)

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

パラメータ

domain

ドメイン。

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

戻り値

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

エラー / 例外

domain が空の string であるか、1024 バイトより長い場合、 ValueError がスローされます。

domain または directory にヌルバイトが含まれている場合、 ValueError がスローされます。

変更履歴

バージョン 説明
8.4.4 domain または directory にヌルバイトが含まれている場合、 ValueError をスローするようになりました。
8.4.0 directory パラメータが任意になりました。 これより前のバージョンでは、常に指定しなければなりませんでした。
8.0.3 directory は、nullable になりました。 これより前のバージョンでは、現在設定されているディレクトリを取得できませんでした。
8.0.0 domain が空の string であるか、長すぎる場合、 ValueError をスローするようになりました。 これより前のバージョンでは、E_WARNING が発生し、false を返していました。

例

例1 bindtextdomain の例

<?php

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

?>

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

/usr/share/myapp/locale

注意

注意:

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