google translate phpダウンロード - google translate phpソースコードダウンロード

google translate php

その他のカテゴリー

v5.2.0

ダウンロード

Google翻訳PHP

無料の Google 翻訳 API PHP パッケージ。完全無料で翻訳します。

インストール
基本的な使い方
高度な使用法
- 言語検出
- サポートされている言語
- パラメータの保存
- 生の応答の使用
- カスタムURL
- HTTP クライアントの構成
- カスタムトークンジェネレーター
- エラーと例外処理
既知の制限事項
免責事項
寄付

インストール

このパッケージは Composer 経由でインストールします。

 composer require stichoza/google-translate-php

注: PHP 8.0 以降が必要です。古い PHP バージョンの場合は、このパッケージの次のバージョンを使用してください。

パッケージバージョン	PHPのバージョン	ドキュメント
`^5.1`	PHP >= 8.0	v5 ドキュメント
`^4.1`	PHP >= 7.1	v4 ドキュメント
`^3.2`	PHP < 7.1	v3 ドキュメント

基本的な使い方

GoogleTranslate オブジェクトを作成する

 use Stichoza  GoogleTranslate  GoogleTranslate ;

$ tr = new GoogleTranslate ( ' en ' ); // Translates into English

または、後で言語を変更することもできます

 $ tr = new GoogleTranslate (); // Translates to ' en ' from auto - detected language by default
$ tr -> setSource ( ' en ' ); // Translate from English
$ tr -> setSource (); // Detect language automatically
$ tr -> setTarget ( ' ka ' ); // Translate to Georgian

文章を翻訳する

 echo $ tr -> translate ( ' Hello World! ' );

また、メソッドチェーンを使用することもできます

 echo $ tr -> setSource ( ' en ' )-> setTarget ( ' ka ' )-> translate ( ' Goodbye ' );

または、短縮形の静的メソッドtrans呼び出します。

 echo GoogleTranslate:: trans ( ' Hello again ' , ' ka ' , ' en ' );

高度な使用法

言語検出

言語を自動的に検出するには、ソース言語をnullに設定するだけです。

 $ tr = new GoogleTranslate ( ' es ' , null ); // Or simply do not pass the second parameter

 $ tr -> setSource (); // Another way

getLastDetectedSource()を使用して、検出された言語を取得します。

 $ tr = new GoogleTranslate ( ' fr ' );

$ text = $ tr -> translate ( ' Hello World! ' );

echo $ tr -> getLastDetectedSource (); // Output : en

言語が検出できなかった場合、戻り値はnullになります。

サポートされている言語

languagesメソッドを使用すると、サポートされているすべての言語のリストを取得できます。

 $ tr = new GoogleTranslate ();

$ languages = $ tr -> languages (); // Get supported languages in iso - 639 format

// Output : [ 'ab' , 'ace' , 'ach' , 'aa' , 'af' , 'sq' , 'alz' , ... ]

必要に応じて、ターゲット言語コードを渡して、その言語で表示される名前を持つサポートされている言語を取得します。

 $ tr = new GoogleTranslate ();

$ languages = $ tr -> languages ( ' en ' ); // Get supported languages , display name in english
// Output : [ 'en' => English' , ' es ' => ' Spanish ' , ' it' => 'Italian' , ... ]

echo $ languages [ ' en ' ]; // Output : ' English '
echo $ languages [ ' ka ' ]; // Output : ' Georgian '

translate / transメソッドと同様に、静的langsメソッドも使用できます。

GoogleTranslate:: langs ();
// Output : [ 'ab' , 'ace' , 'ach' , 'aa' , 'af' , 'sq' , 'alz' , ... ]

GoogleTranslate:: langs ( ' en ' );
// Output : [ 'en' => English' , ' es ' => ' Spanish ' , ' it' => 'Italian' , ... ]

サポートされている言語は、Google API ドキュメントにもリストされています。

パラメータの保存

preserveParameters()メソッドを使用すると、翻訳の実行中に文字列内の特定のパラメータを保存できます。これは、特定のプレースホルダーを翻訳から除外する必要があるローカリゼーションファイルまたはテンプレートエンジンを扱う場合に特に便利です。

デフォルトの正規表現は/:(w+)/で、 :で始まるパラメータをカバーします。 Laravel やその他のフレームワークの言語ファイルを翻訳するのに役立ちます。カスタム正規表現を渡してパラメータ構文を変更することもできます。

 $ tr = new GoogleTranslate ( ' de ' );

$ text = $ tr -> translate ( ' Page :current of :total ' ); // Seite : aktuell von : gesamt

$ text = $ tr -> preserveParameters ()
           -> translate ( ' Page :current of :total ' ); // Seite : current von : total

または、カスタム正規表現を使用します。

 $ text = $ tr -> preserveParameters ( ' /{{([^}]+)}}/ ' )
           -> translate ( ' Page {{current}} of {{total}} ' ); // Seite { { current } } von { { total } }

同じ機能を静的なtrans()メソッドでも使用できます。

GoogleTranslate:: trans ( ' Welcome :name ' , ' fr ' , preserveParameters: true ); // Default regex

GoogleTranslate:: trans ( ' Welcome {{name}} ' , ' fr ' , preserveParameters: ' /{{([^}]+)}}/ ' ); // Custom regex

生の応答の使用

高度な使用方法では、Google 翻訳が提供する生の結果が必要になる場合があります。それにはgetResponseメソッドを使用できます。

 $ responseArray = $ tr -> getResponse ( ' Hello world! ' );

カスタムURL

setUrlメソッドを使用して、デフォルトの Google 翻訳 URL をオーバーライドできます。一部の国では便利

 $ tr -> setUrl ( ' http://translate.google.cn/translate_a/single ' );

HTTP クライアントの構成

このパッケージは HTTP リクエストに Guzzle を使用します。 Guzzle クライアント構成オプションの配列を 3 番目のパラメーターとしてGoogleTranslateコンストラクターに渡すか、単にsetOptionsメソッドを使用することができます。

このオプションを使用して、プロキシ、ユーザーエージェント、デフォルトヘッダー、接続タイムアウトなどを構成できます。

 $ tr = new GoogleTranslate ( ' en ' , ' ka ' , [
    ' timeout ' => 10 ,
    ' proxy ' => [
        ' http '  => ' tcp://localhost:8125 ' ,
        ' https ' => ' tcp://localhost:9124 '
    ],
    ' headers ' => [
        ' User-Agent ' => ' Foo/5.0 Lorem Ipsum Browser '
    ]
]);

 // Set proxy to tcp : // localhost : 8090
$ tr -> setOptions ([ ' proxy ' => ' tcp://localhost:8090 ' ])-> translate ( ' Hello ' );

// Set proxy to socks5 : // localhost : 1080
$ tr -> setOptions ([ ' proxy ' => ' socks5://localhost:1080 ' ])-> translate ( ' World ' );

詳細については、Guzzle ドキュメントの「クライアントの作成」セクションを参照してください。

カスタムトークンジェネレーター

コンストラクターの 4 番目のパラメーターとしてジェネレーターオブジェクトを渡すか、単にsetTokenProviderメソッドを使用することによって、トークンジェネレータークラスをオーバーライドできます。

ジェネレーターはStichozaGoogleTranslateTokensTokenProviderInterfaceを実装する必要があります。

 use Stichoza  GoogleTranslate  Tokens  TokenProviderInterface ;

class MyTokenGenerator implements TokenProviderInterface
{
    public function generateToken ( string $ source , string $ target , string $ text ): string
    {
        // Your code here
    }
}

そして使用します:

 $ tr -> setTokenProvider ( new MyTokenGenerator );

翻訳クライアント（品質）

Google 翻訳には、翻訳の品質を定義するclientというパラメータがあります。最初はwebappに設定されていましたが、後に Google がgtx値を追加したため、文法と文の全体的な意味の点で翻訳品質が向上しました。

->setClient()メソッドを使用してクライアントを切り替えることができます。たとえば、古いバージョンの変換アルゴリズムを使用する場合は、 $tr->setClient('webapp')->translate('lorem ipsum...')と入力します。デフォルト値はgtxです。

エラーと例外処理

静的メソッドのtrans()と非静的translate()およびgetResponse()メソッドは、次の例外をスローします。

ErrorException何らかの理由で HTTP リクエストが失敗した場合。
UnexpectedValueException Google から受信したデータをデコードできない場合。

v5.1.0以降、具体的な例外はStichozaGoogleTranslateExceptions名前空間で利用できます。

LargeTextException要求されたテキストが大きすぎて翻訳できない場合。
RateLimitException Google が過剰な量のリクエストをブロックした場合。
TranslationRequestException翻訳中にその他の HTTP 関連エラーが発生した場合。
TranslationDecodingException応答の JSON をデコードできない場合。

すべての具体的な例外には下位互換性があるため、古いバージョンを使用していた場合はコードを更新する必要はありません。

TranslationDecodingException UnexpectedValueExceptionを拡張し、 LargeTextException 、 RateLimitException 、およびTranslationRequestExceptionこのパッケージの古いバージョン ( <5.1.0 ) で使用されていたErrorExceptionを拡張します。

さらに、利用可能な翻訳がない場合、 translate()とtrans()メソッドはnullを返します。

既知の制限事項

503 Service Unavailable応答: このエラーが発生した場合は、Google が外部 IP アドレスを禁止しているか、CAPTCHA を解決するよう要求している可能性があります。これはこのパッケージのバグではありません。 Googleはさらに厳しくなり、IPごとに一定時間あたりに許可されるリクエストの数を減らし続けているようです。目立たないようにするために送信するリクエストを減らすか、IP を頻繁に変更してください (プロキシを使用するなど)。 IP が禁止されると、一時的であっても、ケースごとに異なるため、禁止は数分から 12 ～ 24 時間以上続く場合があることに注意してください。
429 Too Many Requests応答: このエラーは基本的に上記で説明したものと同じです。
413 Request Entity Too Large応答: このエラーは、入力文字列が長すぎることを意味します。 Google では、一度に最大 5,000 文字までの翻訳を許可しています。長いテキストを翻訳したい場合は、短い部分に分割して 1 つずつ翻訳することができます。
403 Forbidden応答: これはこのパッケージの問題ではありません。 Google 翻訳自体には、一部の文字や HTML エンティティを翻訳する際にいくつかの問題があります。 #119 (コメント) を参照してください。