Copyright (c) 2009 Danilo Segan Drop in replacement for native gettext. This file is part of PHP-gettext. PHP-gettext is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. PHP-gettext is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with PHP-gettext; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ /* LC_CTYPE 0 LC_NUMERIC 1 LC_TIME 2 LC_COLLATE 3 LC_MONETARY 4 LC_MESSAGES 5 LC_ALL 6 */ // LC_MESSAGES is not available if php-gettext is not loaded // while the other constants are already available from session extension. if (!defined('LC_MESSAGES')) { define('LC_MESSAGES', 5); } require('streams.php'); require('gettext.php'); // Variables global $text_domains, $default_domain, $LC_CATEGORIES, $EMULATEGETTEXT, $CURRENTLOCALE; $text_domains = array(); $default_domain = 'messages'; $LC_CATEGORIES = array('LC_CTYPE', 'LC_NUMERIC', 'LC_TIME', 'LC_COLLATE', 'LC_MONETARY', 'LC_MESSAGES', 'LC_ALL'); $EMULATEGETTEXT = 0; $CURRENTLOCALE = ''; /* Class to hold a single domain included in $text_domains. */ class domain { var $l10n; var $path; var $codeset; } // Utility functions /** * Return a list of locales to try for any POSIX-style locale specification. */ function get_list_of_locales($locale) { /* Figure out all possible locale names and start with the most * specific ones. I.e. for sr_CS.UTF-8@latin, look through all of * sr_CS.UTF-8@latin, sr_CS@latin, sr@latin, sr_CS.UTF-8, sr_CS, sr. */ $locale_names = array(); $lang = NULL; $country = NULL; $charset = NULL; $modifier = NULL; if ($locale) { if (preg_match("/^(?P[a-z]{2,3})" // language code ."(?:_(?P[A-Z]{2}))?" // country code ."(?:\.(?P[-A-Za-z0-9_]+))?" // charset ."(?:@(?P[-A-Za-z0-9_]+))?$/", // @ modifier $locale, $matches)) { if (isset($matches["lang"])) $lang = $matches["lang"]; if (isset($matches["country"])) $country = $matches["country"]; if (isset($matches["charset"])) $charset = $matches["charset"]; if (isset($matches["modifier"])) $modifier = $matches["modifier"]; if ($modifier) { if ($country) { if ($charset) array_push($locale_names, "${lang}_$country.$charset@$modifier"); array_push($locale_names, "${lang}_$country@$modifier"); } elseif ($charset) array_push($locale_names, "${lang}.$charset@$modifier"); array_push($locale_names, "$lang@$modifier"); } if ($country) { if ($charset) array_push($locale_names, "${lang}_$country.$charset"); array_push($locale_names, "${lang}_$country"); } elseif ($charset) array_push($locale_names, "${lang}.$charset"); array_push($locale_names, $lang); } // If the locale name doesn't match POSIX style, just include it as-is. if (!in_array($locale, $locale_names)) array_push($locale_names, $locale); } return $locale_names; } /** * Utility function to get a StreamReader for the given text domain. */ function _get_reader($domain=null, $category=5, $enable_cache=true) { global $text_domains, $default_domain, $LC_CATEGORIES; if (!isset($domain)) $domain = $default_domain; if (!isset($text_domains[$domain]->l10n)) { // get the current locale $locale = _setlocale(LC_MESSAGES, 0); $bound_path = isset($text_domains[$domain]->path) ? $text_domains[$domain]->path : './'; $subpath = $LC_CATEGORIES[$category] ."/$domain.mo"; $locale_names = get_list_of_locales($locale); $input = null; foreach ($locale_names as $locale) { $full_path = $bound_path . $locale . "/" . $subpath; if (file_exists($full_path)) { $input = new FileReader($full_path); break; } } if (!array_key_exists($domain, $text_domains)) { // Initialize an empty domain object. $text_domains[$domain] = new domain(); } $text_domains[$domain]->l10n = new gettext_reader($input, $enable_cache); } return $text_domains[$domain]->l10n; } /** * Returns whether we are using our emulated gettext API or PHP built-in one. */ function locale_emulation() { global $EMULATEGETTEXT; return $EMULATEGETTEXT; } /** * Checks if the current locale is supported on this system. */ function _check_locale_and_function($function=false) { global $EMULATEGETTEXT; if ($function and !function_exists($function)) return false; return !$EMULATEGETTEXT; } /** * Get the codeset for the given domain. */ function _get_codeset($domain=null) { global $text_domains, $default_domain, $LC_CATEGORIES; if (!isset($domain)) $domain = $default_domain; return (isset($text_domains[$domain]->codeset))? $text_domains[$domain]->codeset : ini_get('mbstring.internal_encoding'); } /** * Convert the given string to the encoding set by bind_textdomain_codeset. */ function _encode($text) { $source_encoding = mb_detect_encoding($text); $target_encoding = _get_codeset(); if ($source_encoding != $target_encoding) { return mb_convert_encoding($text, $target_encoding, $source_encoding); } else { return $text; } } // Custom implementation of the standard gettext related functions /** * Returns passed in $locale, or environment variable $LANG if $locale == ''. */ function _get_default_locale($locale) { if ($locale == '') // emulate variable support return getenv('LANG'); else return $locale; } /** * Sets a requested locale, if needed emulates it. */ function _setlocale($category, $locale) { global $CURRENTLOCALE, $EMULATEGETTEXT; if ($locale === 0) { // use === to differentiate between string "0" if ($CURRENTLOCALE != '') return $CURRENTLOCALE; else // obey LANG variable, maybe extend to support all of LC_* vars // even if we tried to read locale without setting it first return _setlocale($category, $CURRENTLOCALE); } else { if (function_exists('setlocale')) { $ret = setlocale($category, $locale); if (($locale == '' and !$ret) or // failed setting it by env ($locale != '' and $ret != $locale)) { // failed setting it // Failed setting it according to environment. $CURRENTLOCALE = _get_default_locale($locale); $EMULATEGETTEXT = 1; } else { $CURRENTLOCALE = $ret; $EMULATEGETTEXT = 0; } } else { // No function setlocale(), emulate it all. $CURRENTLOCALE = _get_default_locale($locale); $EMULATEGETTEXT = 1; } // Allow locale to be changed on the go for one translation domain. global $text_domains, $default_domain; unset($text_domains[$default_domain]->l10n); return $CURRENTLOCALE; } } /** * Sets the path for a domain. */ function _bindtextdomain($domain, $path) { global $text_domains; // ensure $path ends with a slash ('/' should work for both, but lets still play nice) if (substr(php_uname(), 0, 7) == "Windows") { if ($path[strlen($path)-1] != '\\' and $path[strlen($path)-1] != '/') $path .= '\\'; } else { if ($path[strlen($path)-1] != '/') $path .= '/'; } if (!array_key_exists($domain, $text_domains)) { // Initialize an empty domain object. $text_domains[$domain] = new domain(); } $text_domains[$domain]->path = $path; } /** * Specify the character encoding in which the messages from the DOMAIN message catalog will be returned. */ function _bind_textdomain_codeset($domain, $codeset) { global $text_domains; $text_domains[$domain]->codeset = $codeset; } /** * Sets the default domain. */ function _textdomain($domain) { global $default_domain; $default_domain = $domain; } /** * Lookup a message in the current domain. */ function _gettext($msgid) { $l10n = _get_reader(); return _encode($l10n->translate($msgid)); } /** * Alias for gettext. */ function __($msgid) { return _gettext($msgid); } /** * Plural version of gettext. */ function _ngettext($single, $plural, $number) { $l10n = _get_reader(); return _encode($l10n->ngettext($single, $plural, $number)); } /** * Override the current domain. */ function _dgettext($domain, $msgid) { $l10n = _get_reader($domain); return _encode($l10n->translate($msgid)); } /** * Plural version of dgettext. */ function _dngettext($domain, $single, $plural, $number) { $l10n = _get_reader($domain); return _encode($l10n->ngettext($single, $plural, $number)); } /** * Overrides the domain and category for a single lookup. */ function _dcgettext($domain, $msgid, $category) { $l10n = _get_reader($domain, $category); return _encode($l10n->translate($msgid)); } /** * Plural version of dcgettext. */ function _dcngettext($domain, $single, $plural, $number, $category) { $l10n = _get_reader($domain, $category); return _encode($l10n->ngettext($single, $plural, $number)); } /** * Context version of gettext. */ function _pgettext($context, $msgid) { $l10n = _get_reader(); return _encode($l10n->pgettext($context, $msgid)); } /** * Override the current domain in a context gettext call. */ function _dpgettext($domain, $context, $msgid) { $l10n = _get_reader($domain); return _encode($l10n->pgettext($context, $msgid)); } /** * Overrides the domain and category for a single context-based lookup. */ function _dcpgettext($domain, $context, $msgid, $category) { $l10n = _get_reader($domain, $category); return _encode($l10n->pgettext($context, $msgid)); } /** * Context version of ngettext. */ function _npgettext($context, $singular, $plural) { $l10n = _get_reader(); return _encode($l10n->npgettext($context, $singular, $plural)); } /** * Override the current domain in a context ngettext call. */ function _dnpgettext($domain, $context, $singular, $plural) { $l10n = _get_reader($domain); return _encode($l10n->npgettext($context, $singular, $plural)); } /** * Overrides the domain and category for a plural context-based lookup. */ function _dcnpgettext($domain, $context, $singular, $plural, $category) { $l10n = _get_reader($domain, $category); return _encode($l10n->npgettext($context, $singular, $plural)); } // Wrappers to use if the standard gettext functions are available, // but the current locale is not supported by the system. // Use the standard impl if the current locale is supported, use the // custom impl otherwise. function T_setlocale($category, $locale) { return _setlocale($category, $locale); } function T_bindtextdomain($domain, $path) { if (_check_locale_and_function()) return bindtextdomain($domain, $path); else return _bindtextdomain($domain, $path); } function T_bind_textdomain_codeset($domain, $codeset) { // bind_textdomain_codeset is available only in PHP 4.2.0+ if (_check_locale_and_function('bind_textdomain_codeset')) return bind_textdomain_codeset($domain, $codeset); else return _bind_textdomain_codeset($domain, $codeset); } function T_textdomain($domain) { if (_check_locale_and_function()) return textdomain($domain); else return _textdomain($domain); } function T_gettext($msgid) { if (_check_locale_and_function()) return gettext($msgid); else return _gettext($msgid); } function T_($msgid) { if (_check_locale_and_function()) return _($msgid); return __($msgid); } function T_ngettext($single, $plural, $number) { if (_check_locale_and_function()) return ngettext($single, $plural, $number); else return _ngettext($single, $plural, $number); } function T_dgettext($domain, $msgid) { if (_check_locale_and_function()) return dgettext($domain, $msgid); else return _dgettext($domain, $msgid); } function T_dngettext($domain, $single, $plural, $number) { if (_check_locale_and_function()) return dngettext($domain, $single, $plural, $number); else return _dngettext($domain, $single, $plural, $number); } function T_dcgettext($domain, $msgid, $category) { if (_check_locale_and_function()) return dcgettext($domain, $msgid, $category); else return _dcgettext($domain, $msgid, $category); } function T_dcngettext($domain, $single, $plural, $number, $category) { if (_check_locale_and_function()) return dcngettext($domain, $single, $plural, $number, $category); else return _dcngettext($domain, $single, $plural, $number, $category); } function T_pgettext($context, $msgid) { if (_check_locale_and_function('pgettext')) return pgettext($context, $msgid); else return _pgettext($context, $msgid); } function T_dpgettext($domain, $context, $msgid) { if (_check_locale_and_function('dpgettext')) return dpgettext($domain, $context, $msgid); else return _dpgettext($domain, $context, $msgid); } function T_dcpgettext($domain, $context, $msgid, $category) { if (_check_locale_and_function('dcpgettext')) return dcpgettext($domain, $context, $msgid, $category); else return _dcpgettext($domain, $context, $msgid, $category); } function T_npgettext($context, $singular, $plural) { if (_check_locale_and_function('npgettext')) return npgettext($context, $single, $plural, $number); else return _npgettext($context, $single, $plural, $number); } function T_dnpgettext($domain, $context, $singular, $plural) { if (_check_locale_and_function('dnpgettext')) return dnpgettext($domain, $context, $single, $plural, $number); else return _dnpgettext($domain, $context, $single, $plural, $number); } function T_dcnpgettext($domain, $context, $singular, $plural, $category) { if (_check_locale_and_function('dcnpgettext')) return dcnpgettext($domain, $context, $single, $plural, $number, $category); else return _dcnpgettext($domain, $context, $single, $plural, $number, $category); } // Wrappers used as a drop in replacement for the standard gettext functions if (!function_exists('gettext')) { function bindtextdomain($domain, $path) { return _bindtextdomain($domain, $path); } function bind_textdomain_codeset($domain, $codeset) { return _bind_textdomain_codeset($domain, $codeset); } function textdomain($domain) { return _textdomain($domain); } function gettext($msgid) { return _gettext($msgid); } function _($msgid) { return __($msgid); } function ngettext($single, $plural, $number) { return _ngettext($single, $plural, $number); } function dgettext($domain, $msgid) { return _dgettext($domain, $msgid); } function dngettext($domain, $single, $plural, $number) { return _dngettext($domain, $single, $plural, $number); } function dcgettext($domain, $msgid, $category) { return _dcgettext($domain, $msgid, $category); } function dcngettext($domain, $single, $plural, $number, $category) { return _dcngettext($domain, $single, $plural, $number, $category); } function pgettext($context, $msgid) { return _pgettext($context, $msgid); } function npgettext($context, $single, $plural, $number) { return _npgettext($context, $single, $plural, $number); } function dpgettext($domain, $context, $msgid) { return _dpgettext($domain, $context, $msgid); } function dnpgettext($domain, $context, $single, $plural, $number) { return _dnpgettext($domain, $context, $single, $plural, $number); } function dcpgettext($domain, $context, $msgid, $category) { return _dcpgettext($domain, $context, $msgid, $category); } function dcnpgettext($domain, $context, $single, $plural, $number, $category) { return _dcnpgettext($domain, $context, $single, $plural, $number, $category); } } ?>