PHP国际化（i18n）：开发者实用指南

让您的PHP网站走向全球：更高效的国际化解决方案

如果您和我一样，维护着不依赖大型框架（如Laravel或Symfony）的“原生”PHP项目，那么多语言支持（i18n）可能一直是一个小但持续的痛点。

传统的解决方案 gettext 虽然功能强大，但配置起来相当繁琐。尤其是在小型项目中，这种方式就像“杀鸡用牛刀”。我们真正需要的是一种可以快速实现、不会引入太多复杂性的方案。

经过在多个项目中的不断尝试和改进，我们开发出了一套基于PHP数组文件和在线翻译工具的轻量级国际化解决方案。这种方法不仅部署简单，而且维护成本极低。今天，我将这套完整的解决方案无保留地分享给大家。

实战指南：我如何用O.Translator搞定PHP多语言支持

我们的核心思路非常简单：每种语言对应一个PHP文件，文件中包含一个 return 语句，返回一个关联数组。 这种方式简单直观，性能开销极小。

步骤 1：规划您的目录结构

清晰的目录结构就是成功的一半。为了便于管理，我们将所有语言文件放在同一个目录下，并用语言代码来命名，如下所示：

project_root/
├── index.php         // Your main logic file
├── i18n/             // Folder for all language files
│   ├── lang.cn.php   // Chinese language pack
│   ├── lang.en.php   // English language pack
│   └── lang.fr.php   // French language pack

步骤 2：创建您的“语言武器库”

接下来，我们来创建基础语言文件。以中文为例，创建一个 lang.cn.php 文件。文件内容是一个简单的 PHP 数组，键是唯一标识符，值是对应的文本字符串。

lang.cn.php 示例：键保持一致，值随语言变化

步骤 3：进入翻译神器 O.Translator

要手动翻译几十甚至上百条内容吗？这正是程序员最讨厌的重复性工作。这时候，我们的秘密武器 O.Translator 就派上用场了。

它是一个专业的在线文档翻译平台，完美支持 PHP 文件，可以直接读取您的数组，并翻译成 70 多种语言。

整个流程非常简单：

访问 O.Translator 主页，上传您的基础语言文件（如 lang.cn.php）。
选择目标语言，比如英语和法语。
点击翻译，稍等片刻，您的 lang.en.php 和 lang.fr.php 文件就会生成。

让我印象最深的是，O.Translator 支持免费预览部分翻译内容。如果您对结果满意，再决定是否购买完整翻译。用他们自己的话说：“绝不为您不满意的产品买单。”

步骤4：让代码真正运行起来

一切都准备就绪；我们只需最后一步。现在，让我们来修改主文件 index.php，让它能够根据用户选择动态加载对应的语言包。

<?php

// 1. Determine the current language (using a GET parameter for demonstration)
$supported_langs = ['en', 'cn', 'fr'];
$default_lang = 'en';
$lang = isset($_GET['lang']) && in_array($_GET['lang'], $supported_langs) ? $_GET['lang'] : $default_lang;

// 2. Load the corresponding language file
// Use a global variable like $_ or a specific variable like $TEXTS to store the strings
$_ = require_once __DIR__ . "/i18n/lang.{$lang}.php";

?>

在您的 HTML 模板中，您可以像这样轻松调用文本字符串：

<!DOCTYPE html>
<html lang="<?php echo htmlspecialchars($lang); ?>">
<head>
    <meta charset="UTF-8">
    <title><?php echo htmlspecialchars($_['heading_home']); ?></title>
</head>
<body>
    <header>
      <h1><?php echo htmlspecialchars($_['heading_home']); ?></h1>
      <nav>
        <ul>
          <li><?php echo htmlspecialchars($_['heading_about']); ?></li>
          <li><?php echo htmlspecialchars($_['button_read_more']); ?></li>
        </ul>
      </nav>
    </header>
</body>
</html>

就是这样——一个简单的多语言网站就诞生了\！

注意事项与进阶思考

虽然这个方案很轻量，但在上线前有几点值得注意：

如何检测用户的语言？ 示例中使用了类似 ?lang=en 的 GET 参数。在实际应用中，你还可以使用 $_SESSION、$_COOKIE，或者解析浏览器的 Accept-Language 请求头来自动检测。
性能考虑：对于中小型网站，每次请求通过 require_once 加载一个 PHP 文件的性能开销可以忽略不计。如果你的网站访问量很大，可以考虑使用 APC 或 OPcache 等字节码缓存技术进一步优化。
可扩展性：随着语言或文本数量的增加，手动管理文件会变得复杂。这时，你可能需要考虑更专业的 i18n 解决方案，比如 PHP 的 gettext 扩展或框架提供的本地化组件。
翻译一致性：为确保所有语言版本中的品牌名称和术语保持一致，强烈推荐使用 O.Translator 的术语表功能。
高层策略：本文聚焦于技术实现。如果您想进一步了解网站国际化的整体策略，欢迎阅读我们的另一篇深度文章。