baraja-core / deepl
Translate texts. Simply.
Installs: 1 419
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: ^8.1
Requires (Dev)
- phpstan/extension-installer: ^1.1
- phpstan/phpstan: ^1.0
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-nette: ^1.0
- phpstan/phpstan-strict-rules: ^1.0
- psr/log: ^2.0 || ^3.0
- roave/security-advisories: dev-master
- spaze/phpstan-disallowed-calls: ^2.0
- tracy/tracy: ^2.8
This package is auto-updated.
Last update: 2024-12-18 17:35:41 UTC
README
Translate texts. Simply.
A simple library without dependencies for automatic translation of your texts.
📦 Installation
It's best to use Composer for installation, and you can also find the package on Packagist and GitHub.
To install, simply use the command:
$ composer require baraja-core/deepl
You can use the package manually by creating an instance of the internal classes, or register a DIC extension to link the services directly to the Nette Framework.
How to use
The library requires no dependencies. Simply create an instance, pass the API key and start translating:
$apiKey = '...'; $isFreeApiKey = true; $deepl = new \Baraja\Deepl\Deepl($apiKey, $isFreeApiKey); // Translate "Hello!" to DE echo $deepl->translate('Hello!', DeeplLocale::DE);
The library is designed for maximum ease of use. At the same time, you can easily configure all the modules.
Supported languages
You can always get the list of supported languages from the DeeplLocale
enum:
echo 'Supported languages: '; $enumValues = array_map(static fn(\UnitEnum $case): string => htmlspecialchars($case->value ?? $case->name), DeeplLocale::cases()); echo implode(', ', $enumValues);
For normal translation work, we recommend using the built-in enum cases directly:
$deepl->translate('Text', DeeplLocale::CS, DeeplLocale::EN);
The first language parameter specifies the target language of the translation, the second parameter specifies the source language. If you don't specify a language, it will be detected automatically.
Translation cache
We know that translating the same requests over and over again can be very expensive for you, because the API is charged by real requests. Therefore, the library directly implements a native cache that stores translation results in a temporary storage.
The default cache implementation is the FileResultCache
service, in which you can configure a custom disk path. The default storage for the cache is sys_get_temp_dir() . '/deepl'
.
$cache = new \Depl\FileResultCache(__DIR__ . '/cache'); $apiKey = '...'; $deepl = new \Baraja\Deepl\Deepl($apiKey, false, $cache);
📄 License
baraja-core/deepl
is licensed under the MIT license. See the LICENSE file for more details.