Mehrsprachigkeit läuft in Symfony intern so ab, dass alle Texte separiert nach Sprache (bzw. pro “Locale”, dieselbe Sprache kann in mehreren Ländern gesprochen werden) von einer Translator-Klasse “geladen” werden. “Geladen” heißt: Diese Texte können auch aus einem Array kommen, das muss keine Datei sein.
Und man kann die Texte auch nachträglich laden: Dazu gibt es die Funktion addResource, der man die Art der Daten (Array, CSV, …), die Daten an sich, die Locale und die Domain übergibt:
1 2 3 4 5 |
$translator = $this->container->get('translator'); // make sure the ArrayLoader is available: $translator->addLoader('array', new \Symfony\Component\Translation\Loader\ArrayLoader()); // load array data: $translator->addResource('array', $data, $locale, $domain); |
Nun ist es aber so, dass addResource erst mal nur die Daten “bekannt” macht, indem es sie intern in ein “resources”-Array schreibt. Die Daten werden nicht fixiert, und insbesondere nicht in den Symfony-Cache geschrieben. Man kann das allerdings erzwingen, indem man eine (nicht zwingend existente) Übersetzung für diese (neue!) Locale anfragt:
1 2 3 4 5 6 7 |
$translator = $this->container->get('translator'); // make sure the ArrayLoader is available: $translator->addLoader('array', new \Symfony\Component\Translation\Loader\ArrayLoader()); // load array data: $translator->addResource('array', $data, $locale, $domain); // request "dummy" translation to assure translation file is written: $translator->trans('dummy_bugfix_workaround_invalid_id', array(), $domain, $locale); |
Die letzte Zeile ist wichtig, sonst passiert es unter bestimmten Umständen, dass man mit “leeren” Übersetzungen dasteht!
Für die Akten, diese Umstände sind folgende:
Meine Anwendung unterstützt de_COM und en_COM. en_COM ist default_locale und Fallback für de_COM. Beide Sprachen werden initial (d.h., wenn sie lokal noch nicht vorliegen) von extern geholt. Der Fehler tritt nun auf, wenn ich erst de_COM aufrufe. Dann wird en_COM als Fallback in die catalogue.de_COM.php geschrieben – aber als leeres Array, denn en_COM liegt lokal noch nicht vor. Rufe ich jetzt (erst) en_COM auf, wird die catalogue.en_COM.php nicht auf Basis der externen Daten geschrieben, sondern auf Basis des leeres Arrays aus catalogue.de_COM.php. Dabei liegen die Daten für en_COM durchaus vor, sie werden/wurden nur nicht in eine lokale Datei geschrieben, und deshalb beim Schreiben der catalogue.de_COM.php nicht berücksichtigt. Die o.g. Zeile erzwingt das Schreiben der Datei und alles ist tutti.
So: Das war das erste Problem 🙂 Das zweite ist, dass ein mal gecachte “Catalogue”-Dateien nicht aktualisiert werden, wenn sich die Quelle dazu ändert. Die Doku sagt, man muss den Cache dann leeren. Falls das nicht gewünscht wird (etwa, weil man im Zuge eines automatisierten Preview-Prozesses dynamisch Änderungen veröffentlichen können muss), bleibt einem nur das Deaktivieren des Translation-Caches.
Dazu bietet Symfony\Bundle\FrameworkBundle\Translation\Translator die Option “cache_dir”. Auf null gesetzt ist der Cache deaktiviert. Leider kann man diese Option nicht von außen setzen m( Aber man kann seine eigene Translator-Klasse als default definieren, und dort die Option setzen – im Folgenden direkt konfigurierbar implementiert:
config.yml:
1 2 3 4 5 6 |
parameters: translator.class: Acme\ProjectBundle\Translation\AcmeTranslator acme_project: # disabling the cache makes the preview work: enableTranslationCache: false |
Acme\ProjectBundle\DependencyInjection:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
public function getConfigTreeBuilder() { $treeBuilder = new TreeBuilder(); $rootNode = $treeBuilder->root('acme_project'); $rootNode ->children() // ... ->booleanNode('enableTranslationCache') ->defaultTrue() ->end() ->end(); return $treeBuilder; } |
Acme\ProjectBundle\Translation\AcmeTranslator:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
class Translator extends AcmeTranslator { public function __construct(ContainerInterface $container, MessageSelector $selector, $loaderIds = array(), array $options = array()) { // disable translation? $param = $container->getParameter('acme_project'); $enableCache = $param['enableTranslationCache']; if($enableCache == FALSE) { $options['cache_dir'] = null; } parent::__construct($container, $selector, $loaderIds, $options); } } |
HTH