Download the PHP package babymarkt/deepl-php-lib without Composer
On this page you can find all versions of the php package babymarkt/deepl-php-lib. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download babymarkt/deepl-php-lib
More information about babymarkt/deepl-php-lib
Files in babymarkt/deepl-php-lib
Package deepl-php-lib
Short Description DeepL API Client Library supporting PHP >= 7.3 && PHP <= 8.1
License MIT
Homepage https://github.com/Baby-Markt/deepl-php-lib
Informations about the package deepl-php-lib
deepl-php-lib
Deprecated Library !
Hello everyone,
in the last couple of months we didn't give much attention to this projekt. DeepL on the other hand has developed client libraries for Python, .NET and Node.js (see: API-Doc).
Since there is a PHP-Library in the works Github and our track record with maintaining our library hasn't been as good as it should have been, we decided to abandon this library and switch internally to the official one.
To make clear that we won't continue to work on this repository, we will archive it. If anyone from the community wants to continue our work we can put a line in the README to point to the new maintained repository.
Otherwise, we recommend you to check out the new library coming from DeepL.
Thank you to everyone who contributed to this project over the years.
Simple PHP Library for DeepL API. You can translate one or multiple text strings (up to 50) per request.
🇩🇪🇦🇹🇨🇭🇬🇧🇺🇸🇪🇸🇲🇽🇫🇷🇮🇹🇯🇵🇳🇱🇵🇱🇵🇹🇧🇷🇷🇺🇨🇳🇬🇷🇩🇰🇨🇿🇪🇪🇫🇮🇭🇺🇱🇹🇱🇻🇷🇴🇷🇸🇸🇰🇸🇪
CHANGELOG
Install
Use composer if you want to use this library in your project.
Usage
Create an instance with your auth key:
Use the DeepL API Pro:
Translate
Translate one Text:
Translate multiple Texts:
param | Description |
---|---|
$text | Text to be translated. Only UTF8-encoded plain text is supported. The parameter may be specified as an Array and translations are returned in the same order as they are requested. Each of the array values may contain multiple sentences. Up to 50 texts can be sent for translation in one request. |
$sourceLang | Language of the text to be translated. default: "" (DeepL will auto-detect) |
$targetLang | The language into which the text should be translated. default: en |
$tagHandling | Sets which kind of tags should be handled. Options currently available: "xml" |
$ignoreTags | Array of XML tags that indicate text not to be translated. default: null |
$formality | Sets whether the translated text should lean towards formal or informal language. This feature currently works for all target languages except "EN" (English), "EN-GB" (British English), "EN-US" (American English), "ES" (Spanish), "JA" (Japanese) and "ZH" (Chinese). Possible options are: "default" (default) "more" - for a more formal language "less" - for a more informal language |
$splitSentences | Array of XML tags which always cause splits default: null |
$preserveFormatting | Sets whether the translation engine should respect the original formatting, even if it would usually correct some aspects. Possible values are: "0" (default) "1" The formatting aspects affected by this setting include: Punctuation at the beginning and end of the sentence Upper/lower case at the beginning of the sentence |
$nonSplittingTags | Comma-separated list of XML tags which never split sentences. default: null |
$outlineDetection | See: https://www.deepl.com/docs-api/handling-xml/outline-detection/ default: 1 |
$splittingTags | Array of XML tags which always cause splits. default: null |
Supported languages
In Version 2 we removed the internal List of supported Languages. Instead, you can now get an array with the supported Languages directly form DeepL:
You can check for the supported Source-Languages:
Check for the supported Target-Languages:
Monitoring usage
You can now check how much you translate, as well as the limit:
Glossary
Create a glossary
param | Description |
---|---|
$name | Glossary name |
$entries | Array of entries |
$sourceLanguage | The source language into which the glossary rule apply |
$targetLanguage | The target language into which the glossary rule apply |
Delete a glossary
param | Description |
---|---|
$glossaryId | Glossary uuid (set by DeepL when glossary is created) |
List glossaries
Get glossary meta information: creation date, is glossary ready to use ...
param | Description |
---|---|
$glossaryId | Glossary uuid (set by DeepL when glossary is created) |
Get glossary entries
param | Description |
---|---|
$glossaryId | Glossary uuid (set by DeepL when glossary is created) |
Configuring cURL requests
If you need to use a proxy, you can configure the underlying curl client to use one. You can also specify a timeout to avoid waiting for several minutes if Deepl is unreachable
Testing
Run PHP_CodeSniffer Tests:
Run PHPMD Tests:
Run PHPUnit Tests:
Run all tests:
Credits
- babymarkt.de GmbH
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of deepl-php-lib with dependencies
ext-json Version *
ext-curl Version *