Deepl Php Laravel Package

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

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

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.

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.

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.

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.