Extrahieren von gettext-Übersetzungen aus der PHP-Heredoc-Syntax?

Question

Ich verwende die gettext-Funktionen von PHP zur Lokalisierung. Ich benutze Poedit, um die eigentliche Übersetzung vorzunehmen, und mit seiner Funktion "Update from sources" ist es wirklich einfach, alle Strings zu extrahieren, die übersetzt werden müssen - außerhalb der heredoc-Syntax.

Poedit verwendet das xgettext-Programm, um die .po-Dateien aus den PHP-Quellcodedateien zu generieren. Und es funktioniert wunderbar, wenn der PHP-Code so aussieht:

echo "". _("test") ."";

Aber das Folgende wird nicht extrahiert (Beachten Sie, dass ein Pseudo-t-Objekt verwendet werden muss):

echo <<{$->_('test')}
EOD;

In PHP-Code könnten Sie das Problem auf folgende Weise umgehen:

$t
EOD
?>

Aber ich würde wirklich bevorzugen, dass das xgettext-Programm den String aus dem heredoc-Block extrahieren könnte.

Ein Workaround wurde in den Kommentaren der PHP-Dokumentation vorgeschlagen. Der Workaround besteht darin, dem xgettext-Programm mitzuteilen, dass es die PHP-Quelldateien als Python-Code behandeln soll. Aber bei der Verwendung dieses Ansatzes in Poedit erhalte ich viele Syntaxfehler vom xgettext-Parser.

Weiß jemand einen Workaround, um xgettext dazu zu bringen, die Übersetzungen aus der PHP-heredoc-Syntax zu extrahieren?

Ein etwas verwandter Ticket wurde im Ticket-System des gettext-Projekts eröffnet: http://savannah.gnu.org/bugs/?27740 Dies deutet darauf hin, dass die Unterstützung für die heredoc-Syntax verbessert werden könnte?

Answer 1

Ich bin der Berichterstatter des gettext-Tickets, auf das Sie sich in Ihrem Beitrag beziehen. Als ich das Ticket eingereicht habe, hatte ich etwas ganz anderes im Sinn, etwas entlang dieser Linien:

Gettext kann Texte aus solchen heredoc/nowdoc-Strings nicht extrahieren, aber das könnte wirklich nützlich sein, wenn es darum geht, große Textabschnitte zu übersetzen.

In meinem Fall verwende ich gettext in einem CLI-PHP-Skript, um Textabschnitte zu übersetzen, die XML-Markup enthalten. Dieses Markup gehört zum Originaltext und muss ebenfalls übersetzt werden. Jedes Anführungszeichen oder Apostroph im Markup manuell zu escapen, macht die Nachrichten in POedit oder jedem anderen Editor ziemlich schwer lesbar.

In Ihrem Fall scheint es, als würden Sie interpolierten Code in (heredoc/nowdoc)-Strings extrahieren wollen. Sie können dieses Problem leicht umgehen, indem Sie den Text vor der eigentlichen Interpolation vorbereiten:

$t
EOD
?>

Ich glaube nicht, dass dies als Bug betrachtet werden sollte, weil das genaue Äquivalent zum von Ihnen geposteten Code unter Verwendung der heredoc-Syntax wäre:

{$t->_('test')}";
?>

von dem auch gettext die Nachricht "test" nicht extrahieren kann.

Answer 2

Als Befürworter von Gettext seit Jahren fällt es schwer, nicht zu bemerken, dass dieses Ticket jetzt 13 Jahre alt ist und anscheinend das Gettext-Projekt die Situation nicht als Bug oder auf irgendeine Weise kritisch ansieht.

Das Problem selbst besteht darin, dass der xgettext-Extraktor die Heredoc/Nowdoc-PHP-Syntax nicht als gültig behandelt, insbesondere die eingerückte Variante, die seit 7.3 verfügbar ist.

Um den Gettext-Workflow und insbesondere POedit weiterhin nutzen zu können, haben wir eine Bibliothek entwickelt, die die Übersetzungsextraktion (über POT-Dateien) ermöglicht, verfügbar unter https://github.com/vertilia/text oder als Composer-Anforderung:

composer require vertilia/text

Dies kann anderen Entwicklern helfen, dem Gettext-Weg treu zu bleiben.

Haftungsausschluss: Ich bin ein Entwickler von vertilia/text.