PHP 本地化数组 - Lingo.dev CLI

什么是 PHP 本地化数组？

PHP 本地化文件使用 PHP 数组语法来存储翻译字符串。它们通常用于像 Laravel 这样的 PHP 框架中，用于管理多语言应用程序。

例如：

<?php

return [
    'Hello, world!',
    'Welcome to MyApp',

    'welcome_message' => 'Welcome!',
    'error_text'      => 'Something went wrong',

    'navigation' => [
        'home'    => 'Home',
        'about'   => 'About',
        'contact' => 'Contact',
    ],
];

什么是 Lingo.dev CLI？

Lingo.dev CLI 是一个免费的开源命令行工具，用于通过 AI 翻译应用程序和内容。它旨在取代传统的翻译管理软件，同时与现有的流水线集成。

要了解更多，请参阅概述。

关于本指南

本指南解释了如何使用 Lingo.dev CLI 翻译 PHP 本地化文件。

您将学习如何：

从头开始创建项目
配置翻译流水线
使用 AI 生成翻译

先决条件

要使用 Lingo.dev CLI，请确保已安装 Node.js v18+：

❯ node -v
v22.17.0

第 1 步：设置项目

在项目目录中，创建一个 i18n.json 文件：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

此文件定义了翻译流水线的行为，包括翻译的语言以及文件系统中可本地化内容的位置。

要了解更多可用属性，请参阅 i18n.json。

第 2 步：配置源语言环境

源语言环境 是您的内容所编写的原始语言和地区。要配置源语言环境，请在 i18n.json 文件中设置 locale.source 属性：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

源语言环境必须以 BCP 47 语言标签的形式提供。

有关 Lingo.dev CLI 支持的语言环境代码的完整列表，请参阅支持的语言环境代码。

第 3 步：配置目标语言环境

目标语言环境 是您希望将内容翻译成的语言和地区。要配置目标语言环境，请在 i18n.json 文件中设置 locale.targets 属性：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {}
}

第 4 步：创建源内容

如果尚未创建，请创建一个或多个包含待翻译内容的 PHP 本地化文件。这些文件的路径中必须包含源语言环境（例如，作为目录名称如 en/ 或作为文件名的一部分如 messages.en.php）。

第 5 步：创建存储桶

在 i18n.json 文件中，向 buckets 对象添加一个 "php" 对象：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "php": {}
  }
}

在 "php" 对象中，定义一个或多个 include 模式的数组：
```
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "php": {
      "include": ["./[locale]/example.php"]
    }
  }
}
```
这些模式定义了需要翻译的文件。

模式本身：
- 必须包含 [locale] 作为配置语言环境的占位符
- 可以指向文件路径（例如，"[locale]/messages.php"）
- 可以使用星号作为通配符占位符（例如，"[locale]/*.php"）
不支持递归的 glob 模式（例如，**/*.php）。

第 6 步：配置 LLM

Lingo.dev CLI 使用大型语言模型（LLM）通过 AI 翻译内容。要使用这些模型之一，您需要一个支持提供商的 API 密钥。

为了尽快开始，我们推荐使用 Lingo.dev Engine —— 我们自己的托管平台，每月提供 10,000 个免费使用的令牌：

注册一个 Lingo.dev 账户。
运行以下命令：
```
npx lingo.dev@latest login
```
这将打开您的默认浏览器并要求您进行身份验证。
按照提示操作。

第 7 步：生成翻译

在包含 i18n.json 文件的目录中，运行以下命令：

npx lingo.dev@latest run

此命令将执行以下操作：

读取 i18n.json 文件。
查找需要翻译的文件。
从文件中提取可翻译的内容。
使用配置的 LLM 翻译提取的内容。
将翻译后的内容写回文件系统。

首次生成翻译时，会创建一个 i18n.lock 文件。此文件会记录已翻译的内容，防止后续运行时进行不必要的重复翻译。

示例

en/example.php

<?php

return [
    'Hello, world!',
    'Welcome to MyApp',

    "It's \"simple\" with a backslash \\ and newline\nAll text here",

    'welcome_message' => 'Welcome!',
    'error_text'      => 'Something went wrong',

    'navigation' => [
        'home'    => 'Home',
        'about'   => 'About',
        'contact' => 'Contact',
    ],

    'forms' => [
        'login' => [
            'username_label' => 'Username',
            'password_label' => 'Password',
            'submit_button'  => 'Sign In',
        ],
    ],

    'mixed_content' => [
        'title'        => 'Settings',
        'count'        => 42,
        'enabled'      => true,
        'nothing_here' => null,
        'description'  => 'App settings and preferences',
    ],
];

zh/example.php

<?php

return [
    '你好，世界！',
    '欢迎使用 MyApp',

    "它是 \"简单的\"，带有反斜杠 \\ 和换行符\n这里的所有文本",

    'welcome_message' => '欢迎！',
    'error_text'      => '发生了错误',

    'navigation' => [
        'home'    => '首页',
        'about'   => '关于',
        'contact' => '联系',
    ],

    'forms' => [
        'login' => [
            'username_label' => '用户名',
            'password_label' => '密码',
            'submit_button'  => '登录',
        ],
    ],

    'mixed_content' => [
        'title'        => '设置',
        'count'        => 42,
        'enabled'      => true,
        'nothing_here' => null,
        'description'  => '应用设置和偏好',
    ],
];

i18n.json

{
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "php": {
      "include": ["./[locale]/example.php"]
    }
  },
  "$schema": "https://lingo.dev/schema/i18n.json"
}

i18n.lock

version: 1
checksums:
  0ee8d6907f60fa2cc288cc0503ecbba1:
    "0": 0468579ef2fbc83c9d520c2f2f1c5059
    "1": d1c3a9f35e377554a4ccaa467ca26614
    "2": 769caedbdc5246bb9fee615739534bbd
    3/welcome_message: 8778dc41547a2778d0f9482da989fc00
    4/error_text: a3cd2f01c073f1f5ff436d4b132d39cf
    5/navigation/home: 104a3db3b671c04e167eafbe21e57881
    5/navigation/about: 944521eeeed2511833d2299931273c71
    5/navigation/contact: 9afa39bc47019ee6dec6c74b6273967c
    6/forms/login/username_label: 2ee65bc2dd2f12cf2672f95b2a054bf8
    6/forms/login/password_label: 223a61cf906ab9c40d22612c588dff48
    6/forms/login/submit_button: ec7b8f314fe9bc6591006707484ede61
    7/mixed_content/title: 8df6777277469c1fd88cc18dde2f1cc3
    7/mixed_content/description: 063afcd2ea84a82a1acc8f5c9fd8e42f