XXXVIII. Gettext

简介

The gettext functions implement an NLS (Native Language Support) API which can be used to internationalize your PHP applications. Please see the gettext documentation for your system for a thorough explanation of these functions or view the docs at http://www.gnu.org/software/gettext/manual/gettext.html.

需求

To use these functions you must download and install the GNU gettext package from http://www.gnu.org/software/gettext/gettext.html

安装

To include GNU gettext support in your PHP build you must add the option --with-gettext[=DIR] where DIR is the gettext install directory, defaults to /usr/local.

Note to Win32 Users: In order to enable this module on a Windows environment, you must copy gnu_gettext.dll from the DLL folder of the PHP/Win32 binary package to the SYSTEM32 folder of your windows machine. (Ex: C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32). Starting with PHP 4.2.3 the name changed to libintl-1.dll, this requires also iconv.dll to be copied. libintl-1.dll is not needed as of PHP 4.3.8, iconv.dll is not needed as of PHP 5.

运行时配置

该扩展模块未定义任何设置指令。

资源类型

该扩展模块未定义任何资源类型。

预定义常量

该扩展模块未定义任何常量。

目录
bind_textdomain_codeset -- Specify the character encoding in which the messages from the DOMAIN message catalog will be returned
bindtextdomain -- Sets the path for a domain
dcgettext -- Overrides the domain for a single lookup
dcngettext -- Plural version of dcgettext
dgettext -- Override the current domain
dngettext -- Plural version of dgettext
gettext -- Lookup a message in the current domain
ngettext -- Plural version of gettext
textdomain -- Sets the default domain

add a note User Contributed Notes
Gettext

11-Jul-2001 08:40

It is probably obvious to many of you,  but I thought it was worth
mentioning that the domain is the name of the .mo files that contain the
string catalogue (without the extension).



so if you have a
catalogue myPage.mo for each page in './locale/lg/LC_MESSAGE' and some
generic catalogues (e.g. errorMsg.mo) in '/global/locale/lg/LC_MESSAGE',
you can do



bindTextDomain("$myPage",
'./locale');

bindTextDomain('errorMsg','/global/locale'
);

textDomain('myPage');

print(getText('Welcome'));

/.../

if($err)printf(dGetText('errorMsg','you
have an error here'));



Ivan

add a note