deeplcom/deepl-php

[1.20.0] - 2026-08-11

Added

• Added support for using multiple glossaries in text and document translation
  via the TranslateTextOptions::GLOSSARY_IDS and
  TranslateDocumentOptions::GLOSSARY_IDS options (up to 5 glossary IDs).
• Added support for style rules in document translation via the
  TranslateDocumentOptions::STYLE_ID option.
• Added support for translation memories in document translation via the
  TranslateDocumentOptions::TRANSLATION_MEMORY_ID and
  TranslateDocumentOptions::TRANSLATION_MEMORY_THRESHOLD options.
• Added support for the translation memory management endpoints in the
  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().
• Added new model classes TranslationMemorySegment,
  TranslationMemoryTargetSegment, TranslationMemorySegments,
  TranslationMemorySegmentsOptions, TranslationMemoryImport,
  TranslationMemoryExport, TranslationMemoryJob and
  TranslationMemoryJobResult.
• Added the creationTime and updatedTime properties to
  TranslationMemoryInfo.

Changed

• Requests to the pre-signed storage URLs used for translation memory import and export now
  go through a separate HTTP client that is constructed without the DeepL 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

• Added support for using multiple glossaries in text and document translation via the TranslateTextOptions::GLOSSARY_IDS and TranslateDocumentOptions::GLOSSARY_IDS options (up to 5 glossary IDs).
• Added support for style rules in document translation via the TranslateDocumentOptions::STYLE_ID option.
• Added support for translation memories in document translation via the TranslateDocumentOptions::TRANSLATION_MEMORY_ID and TranslateDocumentOptions::TRANSLATION_MEMORY_THRESHOLD options.
• Added support for the translation memory management endpoints in the 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().
• Added new model classes TranslationMemorySegment, TranslationMemoryTargetSegment, TranslationMemorySegments, TranslationMemorySegmentsOptions, TranslationMemoryImport, TranslationMemoryExport, TranslationMemoryJob and TranslationMemoryJobResult.
• Added the creationTime and updatedTime properties to TranslationMemoryInfo.

Changed

• Requests to the pre-signed storage URLs used for translation memory import and export now go through a separate HTTP client that is constructed without the DeepL 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

• Added support for the /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.
• Added new model classes LanguageSupport, LanguageResource, LanguageFeature,
  and ResourceFeature to represent the v3 language response shape.

Changed

• Migrated request bodies for /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).
• Send type as a query parameter on GET /v2/languages instead of in the
  request body.
• Enabled OpenAPI request and response validation for the mock-server CI jobs.

Added

• Added support for the /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.
• Added new model classes LanguageSupport, LanguageResource, LanguageFeature, and ResourceFeature to represent the v3 language response shape.

Changed

• Migrated request bodies for /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).
• Send type as a query parameter on GET /v2/languages instead of in the request body.
• Enabled OpenAPI request and response validation for the mock-server CI jobs.

Added

• Added support for translation memories in text translation via
  TranslateTextOptions::TRANSLATION_MEMORY_ID and
  TranslateTextOptions::TRANSLATION_MEMORY_THRESHOLD.
• Added listTranslationMemories() method to the DeepLClient class for
  listing available translation memories.
• Added new model class TranslationMemoryInfo to represent translation memory data.

Fixed

• Set explicit image for gitlab release CI job to avoid missing $HOME issues.

Added

• Added support for translation memories in text translation via TranslateTextOptions::TRANSLATION_MEMORY_ID and TranslateTextOptions::TRANSLATION_MEMORY_THRESHOLD.
• Added listTranslationMemories() method to the DeepLClient class for listing available translation memories.
• Added new model class TranslationMemoryInfo to represent translation memory data.

Fixed

• Set explicit image for gitlab release CI job to avoid missing $HOME issues.

Added

• Added new language constants from January 2026 API release of 81 new languages.
• Added PHP 8.4 and 8.5 to CI test matrix.
• Added support for style rules CRUD endpoints in the DeepLClient class: createStyleRule(), getStyleRule(), updateStyleRuleName(), updateStyleRuleConfiguredRules(), and deleteStyleRule().
• Added support for style rule custom instruction CRUD endpoints in the DeepLClient class: createStyleRuleCustomInstruction(),
  getStyleRuleCustomInstruction(), updateStyleRuleCustomInstruction(), and deleteStyleRuleCustomInstruction().

Please refer to the README for usage instructions.

Added

• Added new language constants from January 2026 API release of 81 new languages.
• Added PHP 8.4 and 8.5 to CI test matrix.
• Added support for style rules CRUD endpoints in the DeepLClient class: createStyleRule(), getStyleRule(), updateStyleRuleName(), updateStyleRuleConfiguredRules(), and deleteStyleRule().
• Added support for style rule custom instruction CRUD endpoints in the DeepLClient class: createStyleRuleCustomInstruction(), getStyleRuleCustomInstruction(), updateStyleRuleCustomInstruction(), and deleteStyleRuleCustomInstruction(). Please refer to the README for usage instructions.

Changed

• Updated formality tests to accept either formal or informal output when using default formality, since the default formality is automatic.
• Updated testModelType() to just check if the model_type_used is populated if the model_type is specified in the request
• Updated testMixedDirectionText() to add a missing </p> tag
• Improved NotFoundException error message by removing the misleading "check server_url" suggestion.

Fixed

• Skip curl_close call for PHP 8+.

Added

• Added tag_handling_version parameter to translateText() specify which version of the tag handling algorithm to use. Options are v1 and v2.

Added

• Added tag_handling_version parameter to translateText() specify which version of the tag handling algorithm to use. Options are v1 and v2.

Added

• Added 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

• Added 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 the README for usage instructions
• Added style_id option to translateText() which allows text translation with style rules.
• Added new model classes: StyleRuleInfo, ConfiguredRules, and CustomInstruction to support style rules functionality.

Added

• 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 the README for usage instructions
• Added style_id option to translateText() which allows text translation with style rules.
• Added new model classes: StyleRuleInfo, ConfiguredRules, and CustomInstruction to support style rules functionality.

Added

• Added 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

• Added 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

• Added support for the /v3 Multilingual Glossary APIs in the client library while providing backwards compatability for the previous /v2 Glossary endpoints. Please refer to the README or upgrading_to_multilingual_glossaries.md for usage instructions.

Added

• Added support for the /v3 Multilingual Glossary APIs in the client library while providing backwards compatability for the previous /v2 Glossary endpoints. Please refer to the README or upgrading_to_multilingual_glossaries.md for usage instructions.

Fixed

• Fixed DeepLClientOptions wrongly inheriting from TranslateTextOptions,
  when it should be TranslatorOptions.
  • Thanks to VincentLanglet for the
    report

Fixed

• Fixed DeepLClientOptions wrongly inheriting from TranslateTextOptions, when it should be TranslatorOptions.
  • Thanks to VincentLanglet for the report

Added

• 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 instructions.

Changed

• The main functionality of the library is now also exposed via the DeepLClient class. Please change your code to use this over the Translator class whenever convenient.

Fixed

• Fixed the TextResult constructor to be compatible with pre-1.10 versions, to facilitate mocking
  • Thanks to VincentLanglet for #56
• Fixed a bug when generating the platform information with php_uname.
  • Thanks to jochensengier for #57 and that-guy-iain + jimwins for the report.

Added

• Added 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'
• Added the $modelTypeUsed field to translateText() response, that indicates the translation model used when the MODEL_TYPE option is specified.

Added

• Added $billedCharacters to the translate text response.

Added

• Added document minification as a feature before document translation, to allow translation of large docx or pptx files. For more info check the README.

Fixed

• 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 replace invalid sequences.
  • Thanks to VincentLanglet for #43

Fixed

• Update VERSION values to 1.7.1

Added

• 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.

Fixed

• Improve type of translateText function in Translator
  • Thanks to VincentLanglet for #41

Added

• Add optional context parameter for text translation, that specifies additional context to influence translations, that is not translated itself.

Changed

• Added notice in Readme that starting in 2024 the library will drop support for PHP versions that are officially end-of-life.

Fixed

• Add .gitattributes file to exclude irrelevant files from package download.
  • Thanks to VincentLanglet for #30
• Internal CI improvements.

Added

• Allow users to supply their own custom HTTP client to the Translator object, in order to configure timeouts, security features etc more granularly.
  • Thanks to VincentLanglet for the good input and work in #22
• Add curl version to the platform info in the user-agent header (will not be added if the user opts out).

Fixed

• Allow users to translate empty strings without throwing an error.
  • Thanks to VincentLanglet for the work in #24
• Catch any exception thrown when computing the user-agent header and continue without failing the request.

Added

• Script to check our source code for license headers and a step for them in the CI.
• Added platform and node version information to the user-agent string that is sent with API calls, along with an opt-out.
• Add method for applications that use this library to identify themselves in API requests they make.

Fixed

• Fix getUsage request to be a HTTP GET request, not POST.
• Changed document translation to poll the server every 5 seconds. This should greatly reduce observed document translation processing time.

Added

• 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.

Fixed

• Also send options in API requests even if they are default values.

Changed

• Added dependency on psr/log. As this package forms a PHP Standard Recommendation, we don't consider it to break backward-compatibility.

Fixed

• Change the type of the TranslatorOptions::LOGGER option to Psr\Log\LoggerInterface, to correctly support PSR-3 loggers.
  • Pull request #12 thanks to Schleuse.

Added

• Add new formality options: 'prefer_less' and 'prefer_more'.

Changed

• Requests resulting in 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.

Stable release.

Added

• 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.

Changed

• Update contributing guidelines, we can now accept Pull Requests.

Fixed

• Fix GitLab CI config.
• Fix a typo in the readme.
  • Pull request #5 thanks to MartkCz.

Added

• Add support for document translation.

Added

• 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.

Changed

• Remove final keyword from class declarations to facilitate testing.

Fixed

• Added minimum supported PHP version to composer.json.
• Fix cURL client issue: do not round timeouts to whole seconds.
• Fix cURL client issue: consider empty response a retryable-error.
• Check for and reject invalid server_url option.

Initial version.