PHPローカリゼーション配列

Lingo.dev CLIによるPHPローカライゼーションファイルのAI翻訳

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でアプリやコンテンツを翻訳するための無料のオープンソースCLIです。従来の翻訳管理ソフトウェアに代わるものとして設計されており、既存のパイプラインと統合できます。

詳細については、概要をご覧ください。

このガイドについて

このガイドでは、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ローカリゼーションファイルを1つ以上作成してください。これらのファイルは、パスのどこかにソースロケールを含む場所に配置する必要があります（例：ディレクトリ名としてen/や、ファイル名の一部としてmessages.en.phpなど）。

ステップ5. バケットの作成

  1. i18n.jsonファイルのbucketsオブジェクトに"php"オブジェクトを追加します：

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

  2. "php"オブジェクト内で、1つ以上の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"）

    再帰的なグロブパターン（例：**/*.php）はサポートされていません。

ステップ6. LLMの設定

Lingo.dev CLIは、AIでコンテンツを翻訳するために大規模言語モデル（LLM）を使用します。これらのモデルを使用するには、サポートされているプロバイダーからAPIキーが必要です。

可能な限り早く始めるには、毎月10,000トークンの無料使用量を提供する独自のホスティングプラットフォームであるLingo.dev Engineの使用をお勧めします：

  1. Lingo.devアカウントにサインアップしてください。

  2. 次のコマンドを実行します：

    npx lingo.dev@latest login

    これによりデフォルトのブラウザが開き、認証を求められます。

  3. 画面の指示に従ってください。

ステップ7. 翻訳を生成する

「i18n.json」ファイルが含まれているディレクトリで、次のコマンドを実行します：

npx lingo.dev@latest run

このコマンドは：

  1. i18n.jsonファイルを読み込みます。
  2. 翻訳が必要なファイルを見つけます。
  3. ファイルから翻訳可能なコンテンツを抽出します。
  4. 設定されたLLMを使用して抽出されたコンテンツを翻訳します。
  5. 翻訳されたコンテンツをファイルシステムに書き戻します。

翻訳が初めて生成されるとき、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',
    ],
];

es/example.php

<?php

return [
    '¡Hola, mundo!',
    'Bienvenido a MyApp',

    "Es \"simple\" con una barra invertida \\ y salto de línea\nTodo el texto aquí",

    'welcome_message' => '¡Bienvenido!',
    'error_text'      => 'Algo salió mal',

    'navigation' => [
        'home'    => 'Inicio',
        'about'   => 'Acerca de',
        'contact' => 'Contacto',
    ],

    'forms' => [
        'login' => [
            'username_label' => 'Nombre de usuario',
            'password_label' => 'Contraseña',
            'submit_button'  => 'Iniciar sesión',
        ],
    ],

    'mixed_content' => [
        'title'        => 'Configuración',
        'count'        => 42,
        'enabled'      => true,
        'nothing_here' => null,
        'description'  => 'Configuración y preferencias de la aplicación',
    ],
];

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