netlogix / symfony-tolgee-translation-provider

2.1.0 2026-10-23 09:02 UTC

Requires

• php: ^7.4 || ^8.0
• ext-zip: *
• symfony/config: ^5.4 || ^6.4 || ^7.0 || ^8.0
• symfony/http-client: ^5.4 || ^6.4 || ^7.0 || ^8.0
• symfony/intl: ^5.4 || ^6.4 || ^7.0 || ^8.0
• symfony/mime: ^5.4 || ^6.4 || ^7.0 || ^8.0
• symfony/polyfill-intl-icu: ^1.28
• symfony/translation: ^5.4 || ^6.4 || ^7.0 || ^8.0

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.8
• ergebnis/composer-normalize: *
• mockery/mockery: ^1.6
• phpunit/phpunit: ^9.6
• rector/rector: *
• symfony/console: ^5.4 || ^6.4 || ^7.0 || ^8.0
• symfony/framework-bundle: ^5.4 || ^6.4 || ^7.0 || ^8.0
• symfony/phpunit-bridge: ^5.4 || ^6.4 || ^7.0 || ^8.0

MIT

• Sascha Heilmeier

• translation
• provider
• tolgee

Published on Packagist.org on 2026-10-23 09:03 UTC

README

Provides Tolgee integration for Symfony Translation.

DSN example

For https:

DSN=tolgees://PROJECT_ID:API_KEY@default/FILTER_STATES

For http:

DSN=tolgee://PROJECT_ID:API_KEY@default/[FILTER_STATES]

where:

• PROJECT_ID is your tolgee Project ID
• API_KEY is your Tolgee API key
• [FILTER_STATES] this argument is optional.
  Filter translations with state, multiple states separated by comma.
  Possible values: UNTRANSLATED, TRANSLATED, REVIEWED
  tolgee export API

Empty translations

Tolgee does not store empty strings, an empty translation is untranslated. Untranslated keys are read as empty string (''), so include UNTRANSLATED in the filter states to deliver empty translations:

DSN=tolgees://PROJECT_ID:API_KEY@default/TRANSLATED,REVIEWED,UNTRANSLATED

Keep in mind that this applies to every untranslated key in every language: they no longer fall back to another locale but are shown empty.

You get the project ID from the project URL.

Generate an API key on Tolgee

DevSetup

If you want to develop this package, you can use gitpod.io to start a development environment with all dependencies installed.

It also starts a local Tolgee server with a test project. http://localhost:8085

You can use the following commands to pull and push translations from/to Tolgee server.

tests/console translation:pull
tests/console translation:push