PHPackages                             google/cloud-translate - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. google/cloud-translate

ActiveLibrary[API Development](/categories/api)

google/cloud-translate
======================

Cloud Translation Client for PHP

v2.2.0(2mo ago)20215.9M—1.1%2220Apache-2.0PHPPHP ^8.1CI passing

Since Mar 10Pushed 2mo ago53 watchersCompare

[ Source](https://github.com/googleapis/google-cloud-php-translate)[ Packagist](https://packagist.org/packages/google/cloud-translate)[ RSS](/packages/google-cloud-translate/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (16)Versions (89)Used By (20)

Google Cloud Translation for PHP
================================

[](#google-cloud-translation-for-php)

> Idiomatic PHP client for [Translation](https://cloud.google.com/translate/).

[![Latest Stable Version](https://camo.githubusercontent.com/109ffc35d6b92ca2ff34c0b94240d0d391d9c78fc114bb88c088b31c09bed9be/68747470733a2f2f706f7365722e707567782e6f72672f676f6f676c652f636c6f75642d7472616e736c6174652f762f737461626c65)](https://packagist.org/packages/google/cloud-translate) [![Packagist](https://camo.githubusercontent.com/6050c36a9b71180c53cf57c2a96f91b5729825f1310b2bbfa7c1f7ff764f74c7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f676f6f676c652f636c6f75642d7472616e736c6174652e737667)](https://packagist.org/packages/google/cloud-translate)

- [API documentation](https://cloud.google.com/php/docs/reference/cloud-translate/latest)

**NOTE:** This repository is part of [Google Cloud PHP](https://github.com/googleapis/google-cloud-php). Any support requests, bug reports, or development contributions should be directed to that project.

Dynamically translates text between thousands of language pairs. The Cloud Translation API lets websites and programs integrate with the translation service programmatically. The Google Translation API is part of the larger Cloud Machine Learning API family.

### Installation

[](#installation)

To begin, install the preferred dependency manager for PHP, [Composer](https://getcomposer.org/).

Now install this component:

```
$ composer require google/cloud-translate
```

### Authentication

[](#authentication)

Please see our [Authentication guide](https://github.com/googleapis/google-cloud-php/blob/main/AUTHENTICATION.md) for more information on authenticating your client. Once authenticated, you'll be ready to start making requests.

### Sample

[](#sample)

```
use Google\ApiCore\ApiException;
use Google\Cloud\Translate\V3\AdaptiveMtDataset;
use Google\Cloud\Translate\V3\Client\TranslationServiceClient;
use Google\Cloud\Translate\V3\GetAdaptiveMtDatasetRequest;

// Create a client.
$translationServiceClient = new TranslationServiceClient();

// Prepare the request message.
$request = (new GetAdaptiveMtDatasetRequest())
    ->setName($formattedName);

// Call the API and handle any network failures.
try {
    /** @var AdaptiveMtDataset $response */
    $response = $translationServiceClient->getAdaptiveMtDataset($request);
    printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
} catch (ApiException $ex) {
    printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
}
```

### Choosing the Right Client for You

[](#choosing-the-right-client-for-you)

This component offers both a handwritten and generated client, used to access the V2 and V3 translation APIs, respectively. Both clients will receive on-going support and feature additions, however, it is worth noting the streamlined nature of the generated client means it will receive updates more frequently. Additionally, the generated client is capable of utilizing gRPC for its transport (by installing the gRPC extension) while the handwritten client interacts over REST &amp; HTTP/1.1 only.

The handwritten client can be found under `Google\Cloud\Translate\TranslateClient`, whereas the generated client is found under `Google\Cloud\Translate\V3\TranslationServiceClient`.

### Debugging

[](#debugging)

Please see our [Debugging guide](https://github.com/googleapis/google-cloud-php/blob/main/DEBUG.md)for more information about the debugging tools.

### Version

[](#version)

This component is considered GA (generally available). As such, it will not introduce backwards-incompatible changes in any minor or patch releases. We will address issues and requests with the highest priority.

### Next Steps

[](#next-steps)

1. Understand the [official documentation](https://cloud.google.com/translation/docs/).
2. Take a look at [in-depth usage samples](https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/translate/).

###  Health Score

74

—

ExcellentBetter than 100% of packages

Maintenance87

Actively maintained with recent releases

Popularity65

Solid adoption and visibility

Community45

Growing community involvement

Maturity88

Battle-tested with a long release history

 Bus Factor3

3 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~38 days

Recently: every ~60 days

Total

86

Last Release

62d ago

Major Versions

v0.2.1 → v1.0.02017-06-30

v1.21.0 → v2.0.02025-02-08

PHP version history (3 changes)v1.13.2PHP &gt;=7.4

v1.17.3PHP ^8.0

v2.0.3PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/a8713415b20b4be4cec8f8b22741e3cd05f76eee9e38de1de5bf32727349b7c5?d=identicon)[bshaffer](/maintainers/bshaffer)

![](https://www.gravatar.com/avatar/3901206952845568d7557a60855b097f6d1bafaa7a24020cfcf5bb8de74f9d28?d=identicon)[google-cloud](/maintainers/google-cloud)

---

Top Contributors

[![release-please[bot]](https://avatars.githubusercontent.com/in/40688?v=4)](https://github.com/release-please[bot] "release-please[bot] (53 commits)")[![gcf-owl-bot[bot]](https://avatars.githubusercontent.com/in/99011?v=4)](https://github.com/gcf-owl-bot[bot] "gcf-owl-bot[bot] (33 commits)")[![bshaffer](https://avatars.githubusercontent.com/u/103941?v=4)](https://github.com/bshaffer "bshaffer (33 commits)")[![jdpedrie](https://avatars.githubusercontent.com/u/89034?v=4)](https://github.com/jdpedrie "jdpedrie (27 commits)")[![yoshi-automation](https://avatars.githubusercontent.com/u/44816363?v=4)](https://github.com/yoshi-automation "yoshi-automation (20 commits)")[![dwsupplee](https://avatars.githubusercontent.com/u/2079879?v=4)](https://github.com/dwsupplee "dwsupplee (12 commits)")[![vishwarajanand](https://avatars.githubusercontent.com/u/7369612?v=4)](https://github.com/vishwarajanand "vishwarajanand (5 commits)")[![saranshdhingra](https://avatars.githubusercontent.com/u/1038319?v=4)](https://github.com/saranshdhingra "saranshdhingra (3 commits)")[![danielgsims](https://avatars.githubusercontent.com/u/695933?v=4)](https://github.com/danielgsims "danielgsims (1 commits)")[![one-git-wonder](https://avatars.githubusercontent.com/u/50168563?v=4)](https://github.com/one-git-wonder "one-git-wonder (1 commits)")[![chingor13](https://avatars.githubusercontent.com/u/32483?v=4)](https://github.com/chingor13 "chingor13 (1 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (1 commits)")[![vam-google](https://avatars.githubusercontent.com/u/25311427?v=4)](https://github.com/vam-google "vam-google (1 commits)")[![VincentLanglet](https://avatars.githubusercontent.com/u/9052536?v=4)](https://github.com/VincentLanglet "VincentLanglet (1 commits)")[![ajupazhamayil](https://avatars.githubusercontent.com/u/14087896?v=4)](https://github.com/ajupazhamayil "ajupazhamayil (1 commits)")[![greeflas](https://avatars.githubusercontent.com/u/17636915?v=4)](https://github.com/greeflas "greeflas (1 commits)")[![Hectorhammett](https://avatars.githubusercontent.com/u/9062626?v=4)](https://github.com/Hectorhammett "Hectorhammett (1 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/google-cloud-translate/health.svg)

```
[![Health](https://phpackages.com/badges/google-cloud-translate/health.svg)](https://phpackages.com/packages/google-cloud-translate)
```

###  Alternatives

[google/cloud-vision

Cloud Vision Client for PHP

1075.2M24](/packages/google-cloud-vision)[googleads/google-ads-php

Google Ads API client for PHP

3497.6M9](/packages/googleads-google-ads-php)[google/cloud-speech

Cloud Speech Client for PHP

551.7M3](/packages/google-cloud-speech)[google/analytics-data

Google Analytics Data Client for PHP

1188.6M38](/packages/google-analytics-data)[google/cloud-language

Cloud Natural Language Client for PHP

201.2M8](/packages/google-cloud-language)[google/cloud-dialogflow

Google Cloud Dialogflow Client for PHP

791.3M8](/packages/google-cloud-dialogflow)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
