NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1169 most downloaded on Packagist
Official DeepL API Client Library
Latest stable
v1.21.0
Last release 20 days ago
02 Nov 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 34 of 34 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
34 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Translation memories, style rules and multilingual glossaries gained many options and fixes. Read Changed and Deprecated before upgrading; no public A…
TL;DR: new APIs in this release: the Admin API, spoken terms, style profiles and text correction. Translation memories, style rules and multilingual glossaries gained many options and fixes. Read Changed and Deprecated before upgrading; no public API is removed in this release.
translateDocumentUpload(),
translateDocumentGetStatus(), translateDocumentWaitUntilDone() and
translateDocumentDownload(), replacing uploadDocument(),
getDocumentStatus(), waitUntilDocumentTranslationComplete() and
downloadDocument().timeout option (TranslateDocumentOptions::TIMEOUT, seconds) to
translateDocument() and translateDocumentWaitUntilDone(). When it
expires, translateDocumentWaitUntilDone() throws a DeepLException and
translateDocument() a DocumentTranslationException with the document
handle. Without it, both wait without limit as before.filename document translation option
(TranslateDocumentOptions::FILENAME), the file name sent with the upload.
It defaults to the base name of the input file path.style_rule (TranslateDocumentOptions::STYLE_RULE) and
translation_memory (TranslateDocumentOptions::TRANSLATION_MEMORY)
document translation options, replacing style_id and
translation_memory_id.DocumentStatusCode constants class for the values of
DocumentStatus::$status, and DocumentStatus::$documentId, the
document_id returned by the API, or null if the response does not
include it.httpStatusCode and shouldRetry properties to DeepLException.
httpStatusCode is the HTTP status of the failed response, or null if
there was none. shouldRetry is true for HTTP 429, any 5xx status and
transient connection failures; it was previously only set on
ConnectionException.Translator::isFreeAccountAuthKey() (also available on DeepLClient),
replacing isAuthKeyFreeAccount().style_profile option (TranslateTextOptions::STYLE_PROFILE
and TranslateDocumentOptions::STYLE_PROFILE) to translate text and
documents with a style profile, given as an ID string or a StyleProfile.style_rule (TranslateTextOptions::STYLE_RULE) and
translation_memory (TranslateTextOptions::TRANSLATION_MEMORY) text
translation options, taking an ID string or a StyleRuleInfo /
TranslationMemoryInfo. They replace style_id and translation_memory_id.Formality, SentenceSplittingMode,
TagHandlingMode, TagHandlingVersion and ModelType for the values of the
formality, split_sentences, tag_handling, tag_handling_version and
model_type options. The options still accept any string.TextResult::$tagHandlingVersion, the tag_handling_version returned
by the API, or null if the response does not include it.DeepLAdminClient class for the Admin API. It must be created with
an admin API key and supports managing developer keys
(createDeveloperKey(), listDeveloperKeys(), deactivateDeveloperKey(),
renameDeveloperKey(), setDeveloperKeyUsageLimits()) and retrieving usage
analytics (getUsageAnalytics(), getCustomTagUsageAnalytics()).
createDeveloperKey() takes the label as an option
(CreateDeveloperKeyOptions::LABEL). All four developer key changes accept
an extra_body_parameters option (CreateDeveloperKeyOptions and
DeveloperKeyOptions::EXTRA_BODY_PARAMETERS), added last to the JSON body.
setDeveloperKeyUsageLimits() changes only the limits given with the
DeveloperKeyUsageLimitsOptions keys, including speech-to-speech.
DeveloperKey::$label, DeveloperKey::$usageLimits,
KeyUsage::$apiKeyLabel, AdminUsageReport::$totalUsage,
AdminUsageBreakdown::$speechToSpeechMinutes and
CustomTagUsageBreakdown::$speechToSpeechMinutes are null when the
response omits them. createDeveloperKey() is retried only when the request was not
sent: after HTTP 429, a DNS failure, a refused connection or a timeout
before the connection was established.
New public types: DeveloperKey, DeveloperKeyUsageLimits,
DeveloperKeyUsageLimitsOptions, CreateDeveloperKeyOptions,
DeveloperKeyOptions, AdminUsageReport, AdminUsageBreakdown,
AdminUsageGroupBy, KeyUsage, CustomTagUsageReport, CustomTagUsage,
CustomTagUsageBreakdown and CustomTagUsageAggregateBy.de-CH, de-DE,
es-ES, fr-CA and fr-FR to LanguageCode./v2/write/correct endpoint in the DeepLClient class:
correctText(). This applies a minimal-change spelling and grammar
correction pass without rewriting the text for style or tone. It takes an
optional options array; CorrectTextOptions::EXTRA_BODY_PARAMETERS adds
parameters last to the request body, replacing fields with the same key.extra_body_parameters option
(RephraseTextOptions::EXTRA_BODY_PARAMETERS) to rephraseText(), added
last to the request body and replacing fields with the same key.WritingStyle and WritingTone constants classes for the values
of the writing_style and tone rephrase options. Other strings are still
accepted.TranslateDocumentOptions::OUTPUT_FORMAT option to request the
file format of the translated document, for example docx. When it differs
from the input file's format, ENABLE_DOCUMENT_MINIFICATION is ignored.TranslateDocumentOptions::ENABLE_WATERMARK option to add a
"Translated by DeepL" watermark to translated docx and pdf documents.getUsage() to Usage: apiKeyCharacter,
speechToTextMinutes, speechToSpeechMinutes, startTime, endTime and
products (an array of the new UsageProduct class). They are null when
the response does not include them, for example for API Free accounts. The
same holds for the fields of each UsageProduct./v3/spoken-terms) in the
DeepLClient class: createSpokenTerms(), listSpokenTerms(),
getSpokenTerms(), updateSpokenTerms(), getSpokenTermsEntries(),
replaceSpokenTermsList(), deleteSpokenTerms() and
deleteSpokenTermsList(), with the new classes SpokenTerms,
SpokenTermsList, SpokenTermsEntries and SpokenTermsOptions.
updateSpokenTerms() takes the new name and the term lists to merge as the
options SpokenTermsOptions::NAME and SpokenTermsOptions::TERM_LISTS.
createSpokenTerms(), updateSpokenTerms() and replaceSpokenTermsList()
accept SpokenTermsOptions::EXTRA_BODY_PARAMETERS. Terms are trimmed before
they are checked and sent, and spoken terms IDs are URL-encoded in request
paths./v3/style_profiles) in
the DeepLClient class: listStyleProfiles(), createStyleProfile(),
getStyleProfile(), updateStyleProfile() and deleteStyleProfile(), with
the new classes StyleProfile, CreateStyleProfileOptions and
UpdateStyleProfileOptions (which adds NAME). The options of
updateStyleProfile() are optional; without them an empty update is sent.
The glossary, style rule and translation memory ID lists take IDs or
GlossaryInfo / MultilingualGlossaryInfo, StyleRuleInfo and
TranslationMemoryInfo objects. Both options classes accept
EXTRA_BODY_PARAMETERS. StyleProfile::$creationTime and $updatedTime
are required: a response without a valid timestamp throws an
InvalidContentException.LanguageResourceName constants class for the resource values of
getLanguagesForResource() and LanguageResource::$resource, and the
LanguageInclude constants class for its include values.getLanguagesForResource() also accepts an options array as its second
parameter, with the include option
(GetLanguagesForResourceOptions::INCLUDE). The plain list of include values
keeps working.updateMultilingualGlossaryName(),
updateMultilingualGlossaryDictionary(),
updateMultilingualGlossaryDictionaryFromCsv() and
replaceMultilingualGlossaryDictionaryFromCsv(). They take an optional
options array, see MultilingualGlossaryOptions: EXTRA_BODY_PARAMETERS
adds parameters to the JSON request body.getMultilingualGlossaryDictionaryEntries(), returning the
MultilingualGlossaryDictionaryEntries of one dictionary, or throwing
GlossaryNotFoundException if the glossary has no such dictionary.TranslationMemoryJobStatus constants class for the values of
TranslationMemoryJobResult::$status; the TranslationMemoryJobResult::STATUS_*
constants refer to it.Content-Type, Content-Length, Transfer-Encoding and Host in the
headers option are now ignored; previously they were sent and could break
the request.AuthorizationException, like 403; previously a generic
DeepLException.DeepLException; previously they were parsed as
successful results.DeepLException; previously surrounding whitespace was sent and hid
the :fx suffix of free keys.E_USER_DEPRECATED notice once per process (see Deprecated); previously
none. Error handlers that report silenced deprecations now see them.rephraseText() now sends the extra_body_parameters option; previously it
was ignored.MultilingualGlossaryDictionaryEntries terms are now trimmed, then
validated, when sent, and a source term that is a duplicate after trimming
is rejected; previously they were sent untrimmed.InvalidContentException; previously some calls returned null,
empty or partial results or raised PHP warnings. The affected methods are
listed under Fixed.ResourceFeature::$needsSourceSupport and $needsTargetSupport are now
[secure] when the API omits them, as the API spec defines; previously null.TranslationMemoryUtils class (marked @private); code
using it must stop.CURLE_RECV_ERROR) and broken pipes (CURLE_SEND_ERROR)
are now retried like other transient network failures. Proxy failures,
such as a proxy that cannot be resolved (CURLE_COULDNT_RESOLVE_PROXY), are
not retried.translateDocument() now checks that the input file exists before sending
any request and throws a DocumentTranslationException if it does not;
previously the upload request failed.translateDocumentWaitUntilDone() and translateDocument() cut the last
sleep of the wait to the timeout, so the wait no longer runs past it.translateText() accepts the glossary and glossary_ids options without a
source language; the API detects the source language. Document translation
still requires sourceLang with a glossary.max_retries option now counts retries after the first attempt, as
documented: max_retries => 5 (the default) sends a request at most 6
times, and 0 disables retries. Previously it counted attempts, so the
default made only 4 retries and max_retries => 1 made none.CURLE_COULDNT_RESOLVE_HOST) are now retried like
other transient network failures. createDeveloperKey() retries them too, as such a request was not
sent.deepl-php/<version> (<os>) php/<version>.extra_body_parameters values are sent as given in JSON request bodies
(text translation): booleans, numbers, arrays and objects keep their JSON
type. Previously every value was converted to a string, so true was sent as
"1" and arrays failed. In document uploads (a multipart form), booleans are
now sent as true/[secure] and arrays and objects as JSON. Objects with
__toString() that are not JsonSerializable are still sent as their
string, and a value that cannot be JSON-encoded throws a DeepLException.en and pt are no longer rejected client-side; the API
translates them to en-US and pt-PT respectively.getSourceLanguages(), getTargetLanguages(), and getGlossaryLanguages()
now call /v3/languages internally instead of the deprecated
/v2/languages and /v2/glossary-language-pairs endpoints. The returned
lists may include additional languages. No change to public method
signatures or return types.Translator; construct a DeepLClient instead, which extends
it. The methods of Translator move into DeepLClient in the next major
version.GlossaryNotFoundException; catch its parent
NotFoundException instead. Glossary requests still throw it until the next
major version.Translator::uploadDocument(), getDocumentStatus(),
waitUntilDocumentTranslationComplete() and downloadDocument(); use
translateDocumentUpload(), translateDocumentGetStatus(),
translateDocumentWaitUntilDone() and translateDocumentDownload(). They
keep working, raise a silenced E_USER_DEPRECATED notice once per process,
and will be removed in the next major version.TranslateDocumentOptions::STYLE_ID and
TranslateDocumentOptions::TRANSLATION_MEMORY_ID; use STYLE_RULE and
TRANSLATION_MEMORY instead. They keep working, raise a silenced
E_USER_DEPRECATED notice once per process, and will be removed in the
next major version.TranslateTextOptions::STYLE_ID
(style_id) and TranslateTextOptions::TRANSLATION_MEMORY_ID
(translation_memory_id); use STYLE_RULE and TRANSLATION_MEMORY instead.
They keep working, raise a silenced E_USER_DEPRECATED notice once per
process, and will be removed in the next major version.split_sentences aliases 'on', 'default' and 'off';
use the SentenceSplittingMode values '1', '0' and 'nonewlines'. The
aliases keep working and raise a silenced E_USER_DEPRECATED notice once per
process.Translator::isAuthKeyFreeAccount(); use
isFreeAccountAuthKey() instead. It keeps working and raises a silenced
E_USER_DEPRECATED notice once per process.LanguageCode constants (for example LanguageCode::GERMAN).
Pass the language code string instead, for example 'de', or use
getSourceLanguages() / getTargetLanguages(). The constants keep working
and will be removed in the next major version.TranslateDocumentOptions::ENABLE_DOCUMENT_MINIFICATION option and the
DocumentMinifier, DocumentMinificationException and
DocumentDeminificationException classes. They keep working and will be
removed in the next major version; the DeepL API accepts larger documents
(see https://developers.deepl.com/docs/resources/usage-limits).
translateDocument() raises a silenced E_USER_DEPRECATED notice, once per
process, when the option is set.DeepLClient::buildRephraseBodyParams() and the GlossaryUtils
class, which are internal. They keep working; in the next major version
buildRephraseBodyParams() becomes private and GlossaryUtils is removed
from the public API. Use GlossaryEntries::fromTsv(),
GlossaryEntries::fromEntries() and GlossaryEntries::convertToTsv()
instead of GlossaryUtils.LanguageResource::RESOURCE_* constants; use the
LanguageResourceName constants instead. Deprecated
LanguageSupport::INCLUDE_BETA and INCLUDE_EXTERNAL; use
LanguageInclude::BETA and EXTERNAL instead. They keep working and will be
removed in the next major version.getMultilingualGlossaryEntries(), which returns the dictionary
in a one-element array; use getMultilingualGlossaryDictionaryEntries(). It
keeps working and raises a silenced E_USER_DEPRECATED notice once per
process.exportTranslationMemoryToFilepath() now throws a DeepLException before
creating the export job if a file already exists at the output path or its
directory does not exist or is not writable. Previously it failed only after
the export job had run.User-Agent header spelled in another case in the headers option,
such as user-agent, raising an undefined-key warning on construction and
failing translation memory uploads and export downloads. The custom
User-Agent is now sent to the storage URLs as well.max_retries option now throws a DeepLException on construction.
Previously no request was sent and the call failed with a TypeError.%20 instead of +, for example the
lang of getSpokenTermsEntries() and the group_by of
getUsageAnalytics().translateDocument() wraps every failure in a DocumentTranslationException,
including an unreadable input file and exceptions that are not a
DeepLException, and copies httpStatusCode and shouldRetry from a
DeepLException cause.translateDocumentDownload() throws the API's error message on a failed
download with the built-in cURL transport, instead of content: 1.translateDocumentDownload() and downloadTranslationMemoryExport() throw a
DeepLException with a custom HTTP client when the output file cannot be
fully written, instead of leaving a truncated file and returning.waitUntilTranslationMemoryJobDone() running up to 5 seconds past its
timeout; the last sleep is now shortened to the deadline.importTranslationMemoryFromFilepath() emitting a PHP warning for an
input file that exists but cannot be read, which error handlers that turn
warnings into exceptions (Laravel, Symfony) raised as ErrorException. It
now raises only a DeepLException, before any request.translateDocument() calls uploadDocument(), getDocumentStatus(),
waitUntilDocumentTranslationComplete() and downloadDocument() again when
a subclass overrides them.getUsage() raising a raw TypeError for a malformed response. A
response body that is not a JSON object now raises
InvalidContentException, and a usage type whose *_count or *_limit is
missing, null or not numeric is left null instead.translateDocumentUpload() (and the deprecated uploadDocument())
accepting a non-string document_id or document_key in the response, for
example a number; it now raises InvalidContentException.translateDocumentGetStatus() and translateDocumentDownload() (and the
deprecated getDocumentStatus() and downloadDocument()).translateText() raising InvalidContentException when a translation
has no billed_characters; TextResult::$billedCharacters is now null in
that case.headers with a different letter case (for example
user-agent) being sent in addition to the default header instead of
replacing it.TypeError or a raw
\Exception (for example a missing field or an invalid timestamp) in
translateText(), uploadDocument(), getDocumentStatus(), the glossary,
multilingual glossary, spoken terms and style rule methods. They now raise
InvalidContentException. translateText() with a single text no longer
returns null when the response has no translations.translateText() changing the process-wide
mb_substitute_character() setting; the caller's value is now restored.enable_document_minification and supports docx as well as pptx. The
README no longer states a 30 MB document size limit.downloadDocument() and downloadTranslationMemoryExport() returning
without an error and without writing a file when the directory of the output
file does not exist. They now throw a DeepLException before sending a
request.rephraseText() throwing a TypeError when called without a target
language and without options.rephraseText() and correctText() accepting malformed responses: a
response without an improvements list returned null for a single text,
fewer improvements than texts returned a short array, and an improvement
without text returned an empty text. These now throw an
InvalidContentException.getSourceLanguages(), getTargetLanguages(),
getGlossaryLanguages(), getLanguagesForResource() and
getLanguageResources() raising PHP warnings or a TypeError (for example a
missing lang, name or status, a feature that is not an object, or a
body that is not a list), or silently treating a missing usable_as_source
or usable_as_target as [secure]. They now raise InvalidContentException.LanguageCode::ENGLISH and LanguageCode::PORTUGUESE doc comments,
which said these codes may only be used as source languages.getMultilingualGlossaryEntries() and
deleteMultilingualGlossaryDictionary().updateMultilingualGlossary() sending [] instead of {} as the
request body when neither a name nor dictionaries are given.getMultilingualGlossaryEntries() failing on a dictionary without
entries, and on returned terms that do not pass the validation applied to
entries sent to the API. Returned entries are now read as they are.TypeError
when the response body is valid JSON but not an object (for example a string
or null). They now raise InvalidContentException.CustomInstruction::$id being null when a returned custom instruction
has no id, both from the custom instruction methods and in
StyleRuleInfo::$customInstructions. A missing or non-string id now raises
InvalidContentException.TypeError when a response lacks a required field (translation_memory_id,
name or source_language of a translation memory; job_id of a job,
import or export; upload_url of an import; the IDs, language and text of a
segment or target segment). They now raise InvalidContentException.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added support for using multiple glossaries in text and document translation via the TranslateTextOptions::GLOSSARY_IDS and TranslateDocumentOptions::
TranslateTextOptions::GLOSSARY_IDS and
TranslateDocumentOptions::GLOSSARY_IDS options (up to 5 glossary IDs).TranslateDocumentOptions::STYLE_ID option.TranslateDocumentOptions::TRANSLATION_MEMORY_ID and
TranslateDocumentOptions::TRANSLATION_MEMORY_THRESHOLD options.DeepLClient class: getTranslationMemory(),
listTranslationMemorySegments(), deleteTranslationMemory(),
createTranslationMemoryImport(), uploadTranslationMemoryFile(),
createTranslationMemoryExport(), getTranslationMemoryJob(),
waitUntilTranslationMemoryJobDone(), downloadTranslationMemoryExport(),
importTranslationMemoryFromFilepath() and
exportTranslationMemoryToFilepath().
waitUntilTranslationMemoryJobDone() polls through the 'awaiting_input'
status, which an import job keeps reporting for a while after its file has
been uploaded, and accepts an optional timeout in seconds, as do
importTranslationMemoryFromFilepath() and
exportTranslationMemoryToFilepath().TranslationMemorySegment,
TranslationMemoryTargetSegment, TranslationMemorySegments,
TranslationMemorySegmentsOptions, TranslationMemoryImport,
TranslationMemoryExport, TranslationMemoryJob and
TranslationMemoryJobResult.creationTime and updatedTime properties to
TranslationMemoryInfo.Authorization
header, instead of stripping it per request. Headers supplied via TranslatorOptions::HEADERS
are no longer sent to those URLs either — only the User-Agent and the per-request
Content-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 endpoints
in the DeepLClient class: getLanguagesForResource() and getLanguageResources().
These return richer per-resource, per-feature language support than the v2
language endpoint, including newer languages and features.LanguageSupport, LanguageResource, LanguageFeature,
and ResourceFeature to represent the v3 language response shape./v2/translate, /v2/glossaries, and
/v2/write/rephrase to application/json with correctly-typed fields
(e.g. text is sent as an array, show_billed_characters as a boolean,
tag lists as arrays, translation_memory_threshold as an integer).type as a query parameter on GET /v2/languages instead of in the
request body./v3/languages and /v3/languages/resources endpoints
in the DeepLClient class: getLanguagesForResource() and getLanguageResources().
These return richer per-resource, per-feature language support than the v2
language endpoint, including newer languages and features.LanguageSupport, LanguageResource, LanguageFeature,
and ResourceFeature to represent the v3 language response shape./v2/translate, /v2/glossaries, and
/v2/write/rephrase to application/json with correctly-typed fields
(e.g. text is sent as an array, show_billed_characters as a boolean,
tag lists as arrays, translation_memory_threshold as an integer).type as a query parameter on GET /v2/languages instead of in the
request body.extraBodyParameters are sent with
their JSON type rather than always as strings. The API does not coerce, so a string
given for a field it types as a boolean, number or array (for example '0' for
outline_detection) is rejected; pass the matching type instead.Added support for translation memories in text translation via TranslateTextOptions::TRANSLATION_MEMORY_ID and TranslateTextOptions::TRANSLATION_MEMOR
TranslateTextOptions::TRANSLATION_MEMORY_ID and
TranslateTextOptions::TRANSLATION_MEMORY_THRESHOLD.listTranslationMemories() method to the DeepLClient class for
listing available translation memories.TranslationMemoryInfo 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,
when it should be 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
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/DeepL/deepl-php/compare/v1.21.0...HEAD [1.21.0]: https://github.com/DeepL/deepl-php/compare/v1.20.0...v1.21.0 [1.20.0
Initial version.
One column per quarter.