PHP 怎么PHP语言包

wen PHP项目 2026-08-01 208

本文目录导读：

PHP 怎么PHP语言包

最简单的数组方式
使用Gettext扩展
使用第三方库 - Symfony Translation
完整的语言包管理系统
语言切换功能
数据库存储语言包
最佳实践建议

我来详细介绍PHP实现语言包（国际化/i18n）的几种常用方法：

最简单的数组方式

基础实现

<?php
// lang/en.php
return [
    'welcome' => 'Welcome to our website',
    'hello' => 'Hello, :name',
    'login' => 'Login',
    'logout' => 'Logout',
];
// lang/zh.php
return [
    'welcome' => '欢迎访问我们的网站',
    'hello' => '你好，:name',
    'login' => '登录',
    'logout' => '退出',
];

使用类封装

<?php
class Translator {
    private static $translations = [];
    private static $defaultLang = 'zh';
    public static function load($lang) {
        $file = __DIR__ . "/lang/{$lang}.php";
        if (file_exists($file)) {
            self::$translations = require $file;
        }
    }
    public static function setLang($lang) {
        self::load($lang);
    }
    public static function t($key, $params = []) {
        $text = self::$translations[$key] ?? $key;
        // 替换参数
        foreach ($params as $name => $value) {
            $text = str_replace(":{$name}", $value, $text);
        }
        return $text;
    }
}
// 使用示例
Translator::setLang($_GET['lang'] ?? 'zh');
echo Translator::t('welcome'); // 欢迎访问我们的网站
echo Translator::t('hello', ['name' => '张三']); // 你好，张三

使用Gettext扩展

安装配置

// php.ini 中开启
extension=gettext
// 创建翻译文件目录
// locale/zh_CN/LC_MESSAGES/messages.po

Gettext使用示例

<?php
// 初始化gettext
function initGettext($lang = 'zh_CN') {
    $locale = $lang . '.UTF-8';
    putenv("LANG={$locale}");
    setlocale(LC_ALL, $locale);
    $domain = 'messages';
    bindtextdomain($domain, __DIR__ . '/locale');
    textdomain($domain);
}
// 使用gettext
initGettext('zh_CN');
echo gettext("Welcome to our website");
echo _("Hello, World!"); // _() 是 gettext() 的简写
// 带变量的翻译
printf(_("Hello, %s"), '张三');

PO文件示例

# locale/zh_CN/LC_MESSAGES/messages.po
msgid "Welcome"
msgstr "欢迎"
msgid "Hello, %s"
msgstr "你好，%s"

使用第三方库 - Symfony Translation

安装

composer require symfony/translation

使用示例

<?php
use Symfony\Component\Translation\Translator;
use Symfony\Component\Translation\Loader\ArrayLoader;
use Symfony\Component\Translation\Loader\PhpFileLoader;
$translator = new Translator('zh_CN');
// 添加加载器
$translator->addLoader('php', new PhpFileLoader());
$translator->addLoader('array', new ArrayLoader());
// 加载翻译文件
$translator->addResource('php', __DIR__ . '/lang/zh.php', 'zh_CN');
$translator->addResource('php', __DIR__ . '/lang/en.php', 'en');
// 使用翻译
echo $translator->trans('welcome');
echo $translator->trans('hello', ['%name%' => '张三']);
// 复数形式
echo $translator->trans('apple', ['%count%' => 5], 'messages', 'zh_CN');

完整的语言包管理系统

<?php
class LanguageManager {
    private $langDir;
    private $currentLang;
    private $translations = [];
    private static $instance = null;
    private function __construct() {
        $this->langDir = __DIR__ . '/lang/';
        $this->currentLang = $this->detectLanguage();
        $this->loadLanguage();
    }
    public static function getInstance() {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }
    private function detectLanguage() {
        // 从会话获取
        if (isset($_SESSION['lang'])) {
            return $_SESSION['lang'];
        }
        // 从Cookie获取
        if (isset($_COOKIE['lang'])) {
            return $_COOKIE['lang'];
        }
        // 从浏览器语言自动检测
        $browserLang = substr($_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? '', 0, 2);
        return in_array($browserLang, ['zh', 'en']) ? $browserLang : 'zh';
    }
    public function setLanguage($lang) {
        if (file_exists($this->langDir . $lang . '.php')) {
            $this->currentLang = $lang;
            $_SESSION['lang'] = $lang;
            setcookie('lang', $lang, time() + 3600 * 24 * 365);
            $this->loadLanguage();
        }
    }
    private function loadLanguage() {
        $file = $this->langDir . $this->currentLang . '.php';
        $this->translations = file_exists($file) ? require $file : [];
    }
    public function t($key, $params = []) {
        $text = $this->translations[$key] ?? $key;
        if (!empty($params)) {
            foreach ($params as $name => $value) {
                $text = preg_replace('/\{' . $name . '\}|:' . $name . '/i', $value, $text);
            }
        }
        return $text;
    }
    public function getCurrentLang() {
        return $this->currentLang;
    }
    public function getAllTranslations() {
        return $this->translations;
    }
}
// 使用示例
$lang = LanguageManager::getInstance();
echo $lang->t('welcome'); // 自动检测语言并翻译
echo $lang->t('hello', ['name' => '李四']);

语言切换功能

<?php
// 语言切换链接
$currentLang = LanguageManager::getInstance()->getCurrentLang();
?>
<div class="language-switcher">
    <a href="?lang=zh" <?php echo $currentLang == 'zh' ? 'class="active"' : ''; ?>>中文</a>
    <a href="?lang=en" <?php echo $currentLang == 'en' ? 'class="active"' : ''; ?>>English</a>
</div>
<?php
// 处理切换请求
if (isset($_GET['lang'])) {
    $allowed = ['zh', 'en', 'ja', 'fr'];
    $requested = $_GET['lang'];
    if (in_array($requested, $allowed)) {
        LanguageManager::getInstance()->setLanguage($requested);
        header('Location: ' . str_replace('?lang=' . $requested, '', $_SERVER['REQUEST_URI']));
    }
}

数据库存储语言包

<?php
class DatabaseTranslator {
    private $db;
    private $translations = [];
    public function __construct($pdo) {
        $this->db = $pdo;
        $this->loadTranslations();
    }
    public function loadTranslations($lang) {
        $stmt = $this->db->prepare("
            SELECT t.key, t.value 
            FROM translations t
            WHERE t.language = :lang
        ");
        $stmt->execute(['lang' => $lang]);
        while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
            $this->translations[$row['key']] = $row['value'];
        }
    }
    public function t($key) {
        return $this->translations[$key] ?? $key;
    }
    // 缓存翻译到文件
    public function cacheToFile($lang) {
        $cacheFile = __DIR__ . "/cache/{$lang}.php";
        $content = "<?php\nreturn " . var_export($this->translations, true) . ";\n";
        file_put_contents($cacheFile, $content);
    }
}