PHPackages                             jefs42/libretranslate - 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. jefs42/libretranslate

ActiveLibrary

jefs42/libretranslate
=====================

PHP interface for the open source LibreTranslate project

v1.1.2(3y ago)3788.2k↓36.8%12[4 issues](https://github.com/jefs42/libretranslate/issues)[1 PRs](https://github.com/jefs42/libretranslate/pulls)1GPL-3.0-or-laterPHPPHP ^7.0|^8.0

Since Apr 3Pushed 2y ago2 watchersCompare

[ Source](https://github.com/jefs42/libretranslate)[ Packagist](https://packagist.org/packages/jefs42/libretranslate)[ RSS](/packages/jefs42-libretranslate/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (1)Versions (6)Used By (1)

libretranslate
==============

[](#libretranslate)

PHP Interface to the open source [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate) project

Install
-------

[](#install)

### Composer (recommended)

[](#composer-recommended)

```
composer require jefs42/libretranslate
```

```
require('vendor/autoload.php');

use Jefs42\LibreTranslate;

$translator = new LibreTranslate();
```

### Manual

[](#manual)

Download the LibreTranslate.php file from src/ directory and place somewhere in you project.

Include the file in your project:

```
require_once("path/to/LibreTranslate.php");

use Jefs42\LibreTranslate;

$translator = new LibreTranslate();
```

Usage
-----

[](#usage)

By default, this class will try to connect to and use a local installation of the LibreTranslate server at

Pass *host* and optionally *port*, *source* and/or *target* parameters to override defaults.

```
// use locally installed LibreTranslate server on port 5000 with default language settings
$translator = new LibreTranslate();

// specify server with alternate port
$translator = new LibreTranslate("https://libretranslate", 5042);

// use localhost, default port, but override default languages used in translations
$translator = new LibreTranslate(null, null, 'de', 'it');
```

[LibreTranslate Mirros](https://github.com/LibreTranslate/LibreTranslate#mirrors)

### Set API Key

[](#set-api-key)

Depending on the server settings, you may need to provide a valid API key to make translation request.

```
$translator->setApiKey('xxxxx-xxxxx-xxxxx');
```

### Set Default Languages

[](#set-default-languages)

The default source and target languages are set by the server. You may override these settings when constructing the class, or as needed:

```
// Set to translate from English to Swedish
$translator->setLanguages('en', 'sv');

// change only one - source or target
$translator->setSource('es');

$translator->setTarget('ru');
```

Each translation function also supports specifying the languages to use when calling the function.

---

### Detect Language

[](#detect-language)

LibreTranslate will attempt to determine the language of the string passed to it.

```
$lang = $translator->detect("mi nombre es jefs42");
// expected result: $lang = 'es'
```

### Translate Text

[](#translate-text)

Translate a string of text, or an array of multiple texts. A server may or may not have a character limit set. For larger texts see Translate File.

```
// translate text using current default source/target languages
$translatedText = $translator->translate("My name is jefs42");

// specifally request languages to use in translation.
// eg. from English to German
$translatedText = $translator->translate("My name is jefs42", "en", "de");

// translate multiple texts in one call
// returns array of translated texts
$translatedText = $translator->translate(["My name is jefs42", "Where is the bathroom?"]);
```

### Translate File

[](#translate-file)

Translate a file of text.

Check $translator->Settings(), current supported formats appear to be - .txt, .odt, .odp, .docx and .pptx

```
// translate file using current default source/target languages
$translatedText = $translator->translateFile("/full/path/to/file.txt");

// translate file with specific source/target languages
// eg. from English to Italian
$translatedText = $translator->translateFile("/full/path/to/file.txt", "en", "it");
```

- Translation server may have max size limits on post/files size.
- Could pass $\_SERVER\['FILES'\]\['formfield'\]\['tmp\_name'\] if using for a web form.

### Suggest

[](#suggest)

Submit a suggested translation to the server.

```
// Submit suggestion using current source/target language
$translator->suggest('My name is jefs42', 'Mi nombre es jefs42');

// Specify languages for suggestion
$translator->suggest('My name is jefs42', 'Mi chiamo jefs42', 'en', 'it');
```

Sugesstions must be enabled on the LibreTranslate server.

---

### Get Available Languages

[](#get-available-languages)

Get the list of languages available on the current server.

```
$languages = $translator->Languages();
/*
Returns array of language codes/names:
[en] => 'English',
[it] => 'Italian',
...
*/
```

### Check Server Settings

[](#check-server-settings)

Get settings current server is running with.

```
$settings = $translator->Settings();
/*
Returns array of settings and their current values:
[api_keys] => 1,
[keyRequired] => ,
[char_limit] => -1,
...
*/
```

See [LibreTranslate Arguments](https://github.com/LibreTranslate/LibreTranslate#arguments) for server settings.

---

LTManage
--------

[](#ltmanage)

If you are running a locally hosted LibreTranslate server, you may have access to `ltmanage`. This allows you to view current keys and their request limits, as well as create new keys and delete current keys.

See [LibreTranslate Manage Keys](https://github.com/LibreTranslate/LibreTranslate#manage-api-keys) for details.

If `ltmanage` is found in the local path then the following additonal functions will be available for use:

### listKeys

[](#listkeys)

Will return an array of current keys and their request limits.

```
$keys = $translator->listKeys();
/*
Returns array of current keys and limits:
[
    'key1' => '500',
    'key2' => '50',
    ...
]
*/
```

### addKey

[](#addkey)

Create a new key for local server with optional request limit.

```
// create a new key limited to server defaults
$key = $translator->addKey();

// create a new key with a specific request limit (higher or lower than server default)
$key = $translator->addKey(400); // limit to 400 requests per minute

/*
Returns string of new key:
"xxxxx-xxxx-xxxx"
*/
```

### removeKey

[](#removekey)

Delete an existing key from the available keys.

```
try {
    $translator->removeKey("xxxxx-xxxxx-xxxxx");
} catch (Exception $e) {
    // key doesn't exist
}
/*
Returns true on deletion
*/
```

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity44

Moderate usage in the ecosystem

Community19

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.8% of commits — single point of failure

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 ~119 days

Total

4

Last Release

1150d ago

PHP version history (2 changes)v1.0.0PHP ^7.2|^8.0

v1.1.2PHP ^7.0|^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6254923?v=4)[JefS42](/maintainers/jefs42)[@jefs42](https://github.com/jefs42)

---

Top Contributors

[![jefs42](https://avatars.githubusercontent.com/u/6254923?v=4)](https://github.com/jefs42 "jefs42 (14 commits)")[![arkonisus](https://avatars.githubusercontent.com/u/7242966?v=4)](https://github.com/arkonisus "arkonisus (2 commits)")[![tabuna](https://avatars.githubusercontent.com/u/5102591?v=4)](https://github.com/tabuna "tabuna (1 commits)")[![tacman](https://avatars.githubusercontent.com/u/619585?v=4)](https://github.com/tacman "tacman (1 commits)")

---

Tags

phptranslatelibretranslate

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jefs42-libretranslate/health.svg)

```
[![Health](https://phpackages.com/badges/jefs42-libretranslate/health.svg)](https://phpackages.com/packages/jefs42-libretranslate)
```

###  Alternatives

[aurawindsurfing/google-translate

Free Laravel package for Paid Google Translate REST API with your own API key

1119.5k1](/packages/aurawindsurfing-google-translate)

PHPackages © 2026

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