NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #1254 most downloaded on Packagist
Official DeepL API Client Library
Last release 1 months ago
11 Aug 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 33 of 33 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
33 releases · first in 2022
One column per quarter.
Added support for using multiple glossaries in text and document translation via the TranslateTextOptions::GLOSSARY_IDS and TranslateDocumentOptions::
TranslateTextOptions::GLOSSARY_IDS andTranslateDocumentOptions::GLOSSARY_IDS options (up to 5 glossary IDs).TranslateDocumentOptions::STYLE_ID option.TranslateDocumentOptions::TRANSLATION_MEMORY_ID andTranslateDocumentOptions::TRANSLATION_MEMORY_THRESHOLD options.DeepLClient class: getTranslationMemory(),listTranslationMemorySegments(), deleteTranslationMemory(),createTranslationMemoryImport(), uploadTranslationMemoryFile(),createTranslationMemoryExport(), getTranslationMemoryJob(),waitUntilTranslationMemoryJobDone(), downloadTranslationMemoryExport(),importTranslationMemoryFromFilepath() andexportTranslationMemoryToFilepath().waitUntilTranslationMemoryJobDone() polls through the 'awaiting_input'importTranslationMemoryFromFilepath() andexportTranslationMemoryToFilepath().TranslationMemorySegment,TranslationMemoryTargetSegment, TranslationMemorySegments,TranslationMemorySegmentsOptions, TranslationMemoryImport,TranslationMemoryExport, TranslationMemoryJob andTranslationMemoryJobResult.creationTime and updatedTime properties toTranslationMemoryInfo.AuthorizationTranslatorOptions::HEADERSUser-Agent and the per-requestContent-Type. Proxy settings are unaffected.Added support for the /v3/languages and /v3/languages/resources endpoints in the DeepLClient class: getLanguagesForResource() and getLanguageResources
/v3/languages and /v3/languages/resources endpointsDeepLClient class: getLanguagesForResource() and getLanguageResources().LanguageSupport, LanguageResource, LanguageFeature,ResourceFeature to represent the v3 language response shape./v2/translate, /v2/glossaries, and/v2/write/rephrase to application/json with correctly-typed fieldstext is sent as an array, show_billed_characters as a boolean,translation_memory_threshold as an integer).type as a query parameter on GET /v2/languages instead of in theAdded support for translation memories in text translation via TranslateTextOptions::TRANSLATION_MEMORY_ID and TranslateTextOptions::TRANSLATION_MEMOR
TranslateTextOptions::TRANSLATION_MEMORY_ID andTranslateTextOptions::TRANSLATION_MEMORY_THRESHOLD.listTranslationMemories() method to the DeepLClient class forTranslationMemoryInfo to represent translation memory data.gitlab release CI job to avoid missing $HOME issues.Added new language constants from January 2026 API release of 81 new languages.
DeepLClient class: createStyleRule(), getStyleRule(), updateStyleRuleName(), updateStyleRuleConfiguredRules(), and deleteStyleRule().DeepLClient class: createStyleRuleCustomInstruction(),getStyleRuleCustomInstruction(), updateStyleRuleCustomInstruction(), and deleteStyleRuleCustomInstruction().Please refer to the README for usage instructions.
DeepLClient class:
createStyleRule(), getStyleRule(), updateStyleRuleName(),
updateStyleRuleConfiguredRules(), and deleteStyleRule().DeepLClient class: createStyleRuleCustomInstruction(),
getStyleRuleCustomInstruction(), updateStyleRuleCustomInstruction(),
and deleteStyleRuleCustomInstruction().
Please refer to the README for usage instructions.testModelType() to just check if the model_type_used is populated if the model_type is specified in the requesttestMixedDirectionText() to add a missing </p> tagNotFoundException error message by removing the misleading "check server_url" suggestion.curl_close call for PHP 8+.Added tag_handling_version parameter to translateText() specify which version of the tag handling algorithm to use. Options are v1 and v2 .
tag_handling_version parameter to translateText() specify which version of the tag handling algorithm to use. Options are v1 and v2.Added custom_instructions parameter to translateText() to customize translation behavior with up to 10 instructions (max 300 characters each). Only su
custom_instructions parameter to translateText() to customize translation behavior with up to 10 instructions (max 300 characters each). Only supported for target languages: de, en, es, fr, it, ja, ko, zh and their variants. Note: using the custom_instructions parameter will use the quality_optimized model type as the default. Requests combining custom_instructions and the latency_optimized model type will be rejected.Added support for the GET /v3/style_rules endpoint in the client library, the implementation can be found in the DeepLClient class. Please refer to th
GET /v3/style_rules endpoint in the client library, the implementation can be found in the DeepLClient class. Please refer to the README for usage instructionsstyle_id option to translateText() which allows text translation with style rules.StyleRuleInfo, ConfiguredRules, and CustomInstruction to support style rules functionality.Added extraRequestParameters option to text and document translation methods to pass arbitrary parameters in the request body. This can be used to acc
extraRequestParameters option to text and document translation methods to pass arbitrary parameters in the request body. This can be used to access beta features or override built-in parameters (such as target_lang, source_lang, etc.).Added support for the /v3 Multilingual Glossary APIs in the client library while providing backwards compatability for the previous /v2 Glossary endpo
Fixed DeepLClientOptions wrongly inheriting from TranslateTextOptions , when it should be TranslatorOptions .
DeepLClientOptions wrongly inheriting from TranslateTextOptions,TranslatorOptions.
Added support for the Write API in the client library, the implementation can be found in the DeepLClient class. Please refer to the README for usage
DeepLClient class. Please refer to the README for usage
instructions.DeepLClient
class. Please change your code to use this over the Translator class whenever
convenient.Fixed the TextResult constructor to be compatible with pre-1.10 versions, to facilitate mocking
TextResult constructor to be compatible with pre-1.10 versions, to
facilitate mocking
php_uname.
Added MODEL_TYPE option to translateText() to use models with higher translation quality (available for some language pairs), or better latency. Optio
MODEL_TYPE option to translateText() to use models with higher
translation quality (available for some language pairs), or better latency.
Options are 'quality_optimized', 'latency_optimized', and 'prefer_quality_optimized'$modelTypeUsed field to translateText() response, that
indicates the translation model used when the MODEL_TYPE option is
specified.Added $billedCharacters to the translate text response.
$billedCharacters to the translate text response.Added document minification as a feature before document translation, to allow translation of large docx or pptx files. For more info check the README
docx or pptx files. For more info check the README.Added a workaround for rare cases that the DeepL API responds with invalid UTF-8 sequences. In these cases the replacement character "�" (U+FFFD) will
### Fixed - Update VERSION values to 1.7.1
VERSION values to 1.7.1New language available: Arabic ('ar'). Add language code constants and tests. Arabic is currently supported only for text translation; document transl
New language available: Arabic ('ar'). Add language code constants and tests.
Arabic is currently supported only for text translation; document translation
support for Arabic is coming soon.
Note: older library versions also support the new language, this update only adds new code constants.
translateText function in Translator
Add optional context parameter for text translation, that specifies additional context to influence translations, that is not translated itself.
context parameter for text translation, that specifies
additional context to influence translations, that is not translated itself.Add .gitattributes file to exclude irrelevant files from package download.
.gitattributes file to exclude irrelevant files from package download.
Allow users to supply their own custom HTTP client to the Translator object, in order to configure timeouts, security features etc more granularly.
Translator object, in order to configure timeouts, security features etc more granularly.
Script to check our source code for license headers and a step for them in the CI.
New languages available: Korean ('ko') and Norwegian (bokmål) ('nb'). Add language code constants and tests.
New languages available: Korean ('ko') and Norwegian (bokmål) ('nb'). Add language code constants and tests.
Note: older library versions also support the new languages, this update only adds new code constants.
Also send options in API requests even if they are default values.
Added dependency on psr/log. As this package forms a PHP Standard Recommendation, we don't consider it to break backward-compatibility.
psr/log. As this package forms a PHP Standard
Recommendation, we don't consider it to break backward-compatibility.Add new formality options: 'prefer_less' and 'prefer_more'.
'prefer_less' and 'prefer_more'.503 Service Unavailable errors are now retried.
Attempting to download a document before translation is completed will now
wait and retry (up to 5 times by default), rather than throwing an exception.Add glossary management support.
Stable release.
Add glossary management support.
New language available: Ukrainian ('uk'). Add language code constant and tests.
Note: older library versions also support new languages, this update only adds new code constant.
Add proxy support.
Update contributing guidelines, we can now accept Pull Requests.
Add support for document translation.
New languages available: Indonesian ('id') and Turkish ('tr'). Add language code constants and tests.
New languages available: Indonesian ('id') and Turkish ('tr'). Add language code constants and tests.
Note: older library versions also support the new languages, this update only adds new code constants.
Remove final keyword from class declarations to facilitate testing.
final keyword from class declarations to facilitate testing.Added minimum supported PHP version to composer.json.
server_url option.[Unreleased]: https://github.com/DeepLcom/deepl-php/compare/v1.20.0...HEAD [1.20.0]: https://github.com/DeepLcom/deepl-php/compare/v1.19.0...v1.20.0 [
Initial version.
Your coding agent can read these notes before it upgrades. Set up the MCP server →