cvs: peardoc /de/package/internationalization/translation2 intro.xml

From: Date: Sat, 11 Mar 2006 15:39:36 +0000
Subject: cvs: peardoc /de/package/internationalization/translation2 intro.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-7659@lists.php.net to get a copy of this message
alexmerz Sat Mar 11 15:39:36 2006 UTC Added files: /peardoc/de/package/internationalization/translation2 intro.xml Log: initial translation

http://cvs.php.net/viewcvs.cgi/peardoc/de/package/internationalization/translation2/intro.xml?view=markup&rev=1.1 Index: peardoc/de/package/internationalization/translation2/intro.xml +++ peardoc/de/package/internationalization/translation2/intro.xml <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.14 Maintainer: alexmerz Status: ready --> <refentry id="package.internationalization.translation2.intro"> <refnamediv> <refname>Einführung</refname> <refpurpose>Die Verwendung von <classname>Translation2</classname></refpurpose> </refnamediv> <refsect1 id="package.internationalization.translation2.intro.whatis"> <title>Was ist Translation2?</title> <para> <classname>Translation2</classname> ist eine Klasse um mehrsprachige Anwendungen zu schreiben. Es bietet einfache Möglichkeiten um alle Zeichenketten für eine mehrsprachige Webseite oder Anwendung aus eine Datenquelle zu holen, wie z.B. einer Datenbank. Die API einfach zu verwenden und trotzdem machtig und erweiterbar. Die Klasse <link linkend="package.internationalization.translation2.translation2-admin-summary"> <classname>Translation2_Admin</classname></link> bietet Methoden, um Übersetzungen zu verwalten, wie das Hinzufügen/Entfernen einer Sprache oder Zeichenkette. </para> <para> Die folgenden Container (Datenquellen-Treiber) werden unterstützt: <itemizedlist> <listitem><para><classname>PEAR::DB</classname></para></listitem> <listitem><para><classname>PEAR::MDB</classname></para></listitem> <listitem><para><classname>PEAR::MDB2</classname></para></listitem> <listitem><para>gettext</para></listitem> <listitem> <para><classname>PEAR::DB_DataObject</classname> (experimentell, wird benutzt von PEAR::<link linkend="package.html.html-template-flexy"> <classname>HTML_Template_Flexy</classname></link>) </para> </listitem> <listitem><para>XML</para></listitem> </itemizedlist> </para> <para> Einige Decorator-Klassen sind hilfreiche für bestimmte Situationen. Sie können in beliebiger Reihenfolge aufgeschichtet werden. Dadurch werden sie einer Vielzahl von Ansprüchen gerecht. Derzeit sind folgende Decorator-Klassen enthalten: <itemizedlist> <listitem> <para> <link linkend="package.internationalization.translation2.translation2-decorator-cachelitefunction-summary"> CacheLiteFunction</link> (Für schnelles, datei-basiertes Caching) </para> </listitem> <listitem> <para> <link linkend="package.internationalization.translation2.translation2-decorator-cachememory-summary"> CacheMemory</link> (Für speicher-basiertes Caching) </para> </listitem> <listitem> <para> <link linkend="package.internationalization.translation2.translation2-decorator-defaulttext-summary"> DefaultText</link> (Um leere Zeichenketten durch ihren Schlüssel oder Standardtext zu ersetzen) </para> </listitem> <listitem> <para> <link linkend="package.internationalization.translation2.translation2-decorator-errortext-summary"> ErrorText</link> (Um leere Zeichenketten mit der "error_text"-Medlung zu ersetzen) </para> </listitem> <listitem> <para> <link linkend="package.internationalization.translation2.translation2-decorator-iconv-summary"> Iconv</link> (Um zwischen verschiedenen Zeichensatz-Encodings zu wechseln) </para> </listitem> <listitem> <para> <link linkend="package.internationalization.translation2.translation2-decorator-lang-summary"> Lang</link> (Die Definition von Fallback-Sprachen, wenn Zeichenketten in Übersetzungen nicht zur Verfügung stehen) </para> </listitem> <listitem> <para> <link linkend="package.internationalization.translation2.translation2-decorator-specialchars-summary"> SpecialChars</link> (Ersetzt HTML-Entitäten durch ihre hexadezimale Darstellung) </para> </listitem> <listitem> <para> <link linkend="package.internationalization.translation2.translation2-decorator-specialchars-summary"> UTF-8</link> (Konvertiert Zeichenketten von UTF-8 nach ISO-8859-1) </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.internationalization.translation2.intro.example1"> <title>Beispiel</title> <para> Dieses Beispiel zeigt die Erzeugung eines <classname>Translation2</classname> Objekte und demonstriert die Ermittlung übersetzter Zeichenketten bei der Verwendung des <classname>MDB2</classname>-Treibers: <programlisting role="php"> <![CDATA[ // Die Parameter für die Datenbankverbindung $dbinfo = array( 'hostspec' => 'host', 'database' => 'dbname', 'phptype' => 'mysql', 'username' => 'user', 'password' => 'pwd' ); define('TABLE_PREFIX', 'mytable_'); // Translation2 muss über die eigene DB-Struktur // informatiert werden // Anmerkung: die Standardstruktur ist: // // Tabelle "langs" // (verfügbare Sprachen und Meta-Informationen) // +----+------+------+------------+ // | ID | name | meta | error_text | // +----+------+------+------------+ // // Table "strings" (Übersetzungen) // +----+---------+----+----+----+-----+ // | ID | page_id | en | de | it | ... | // +----+---------+----+----+----+-----+ // Man kann eine Tabelle pro Übersetzung verwenden, statt // einer Tabelle für alle // $params = array( 'langs_avail_table' => TABLE_PREFIX.'langs_avail', 'lang_id_col' => 'ID', 'lang_name_col' => 'name', 'lang_meta_col' => 'meta', 'lang_errmsg_col' => 'error_text', 'strings_tables' => array( 'en' => TABLE_PREFIX.'i18n', 'it' => TABLE_PREFIX.'i18n', 'de' => TABLE_PREFIX.'i18n' ), 'string_id_col' => 'ID', 'string_page_id_col' => 'pageID', 'string_text_col' => '%s' //'%s' wird durch den Sprachcode ersetzt ); $driver = 'MDB2'; require_once 'Translation2.php'; $tr =& Translation2::factory($driver, $dbinfo, $params); // die primäre Sprache setzen $tr->setLang('it'); // die Gruppe von Zeichenkette bestimmen, die geholt werden soll $tr->setPageID('defaultGroup'); // einen Lang-Decorator setzen für die Fallback-Sprache $tr =& $tr->getDecorator('Lang'); $tr->setOption('fallbackLang', 'en'); // Einen weiteren Lang-Decorator für eine zweite Fallback-Sprache // Für den Fall das Zeichenketten weder in Italienisch noch Englisch vorliegen $tr =& $tr->getDecorator('Lang'); $tr->setOption('fallbackLang', 'de'); // Die Zeichenkette mit der stringID 'test' holen echo $tr->get('test'); // Eine Zeichnekette holen, die nicht in Italienisch vorliegt // (Test auf Fallback ins Englische echo $tr->get('only_english'); // Die komplette Gruppe holen, ohne die Fallback-Funktion zu nutzen // und ohne weitere Decorator-Klassen zu durchlaufen $rawPage = $tr->getRawPage(); print_r($rawPage); // Die komplette Gruppe mit Berücksichtung der Decorator $page = $tr->getPage(); print_r($page); // Eine Sprache erzwingen echo $tr->get('month_01', 'calendar', 'it'); // Analog für getRawPage() und getPage() $page = $tr->getPage('calendar', 'de'); print_r($page); ]]> </programlisting> </para> <para> Wie man sehen kann, sind die wichtigsten Methoden <link linkend="package.internationalization.translation2.translation2.get"><function>get</function></link>, <link linkend="package.internationalization.translation2.translation2.getpage"><function>getPage</function></link> und <link linkend="package.internationalization.translation2.translation2.getrawpage"><function>getRawPage</function></link>. Di evollständige Syntax ist <programlisting role="php">get($stringID, $pageID, $langID);</programlisting> aber man kann auf die Parameter <parameter>pageID</parameter> und <parameter>langId</parameter> verzichten, wenn sie vorher gesetzt wurden. </para> <para> <emphasis>Anmerkung:</emphasis> Es muss eine Fehlerprüfung zumindest beim ersten Aufruf einer dieser Methoden vorgenommen werden. Denn an diesen Punkt wird zum erstenmal die Datenbankverbindung aufgebaut. Daher ist hier das Fehlerrisiko am größten. </para> </refsect1> <refsect1 id="package.internationalization.translation2.intro.example2"> <title>Sprachinformationen ermitteln</title> <para> Jetzt schauen wir uns an, wie Meta-Informationen aus der Datenbank ermittelt werden können: <programlisting role="php"> <![CDATA[ $tr->getLang(); // keine langID => aktuelle Sprache $tr->getLang('it'); // wie oben, aber jetzt Italienische langID // Der erste Parameter ist der Sprach-Identifier, // der zweite bestimmt die gewünschte Information $tr->getLang('it', 'error_text'); $tr->getLang('en', 'name'); $tr->getLang('de', 'meta'); $tr->getLang('de', 'encoding'); ]]> </programlisting> </para> </refsect1> <refsect1 id="package.internationalization.translation2.intro.example3"> <title>Die Verendung der Decoratorklassen</title> <para> <classname>Translation2</classname> benutzt <link linkend="package.internationalization.translation2.translation2-decorator-summary">Decoratorklassen</link> um Zeichenketten zu filtern bzw. zu beeinflussen. Es kann eine Reihe von Filtern aufgebaut und auch um Eigene ergänzt werden. <programlisting role="php"> <![CDATA[ $tr =& Translation2::factory($driver, $dbinfo, $params); $tr->setLang('en'); $tr->setPageID('calendar'); // Einen speicher-basierten Cache-Decorator ergänzen // um bestimmte Informationen vorzuladen und die DB-Zugriffe // zu minimieren $tr = & $tr->getDecorator('CacheMemory'); // Einen datei-basierten Decorator laden // um die Seitenzugriffe zu chachen $tr =& $tr->getDecorator('CacheLiteFunction'); $tr->setOption('cacheDir', 'cache/'); $tr->setOption('lifeTime', 3600*24); // Einen Sprach-Decorator ergänzen $tr = & $tr->getDecorator('Lang'); $tr->setOption('fallbackLang', 'it'); // Einen Decorator ergänzen, um Sonderzeichen durch HTML-Entitäten zu ersetzen $tr = & $tr->getDecorator('SpecialChars'); // Den Zeichensatz festlegen $tr->setOption('charset', 'ISO-8859-2'); // Und einen UTF-8-Decorator ergänzen, um UTF-8-Zeichenketten zu ändern $tr = & $tr->getDecorator('UTF8'); // Einen Decorator für den Standardtext ersetzen, wenn // eine leere Zeichenkette gefunden wurde $tr = & $tr->getDecorator('DefaultText'); // Ersetze die leere Zeichenkette mit seiner stringID echo $tr->get('emptyString'); // einen bestimmten Fallback-Text setzen echo $tr->get('emptyString', 'stringGroup', 'en', 'show this default text'); ]]> </programlisting> </para> </refsect1> <refsect1 id="package.internationalization.translation2.intro.example4"> <title>Den Identifier einer Zeichenkette ermitteln</title> <para> Die Methode <link linkend="package.internationalization.translation2.translation2.getstringid"> <function>getStringID</function></link> ist die Umkehrung von <link linkend="package.internationalization.translation2.translation2.get"> <function>get</function></link>. Wenn eine Zeichenkette in eine andere Sprache übersetzt werden soll, ist es nicht erforderlich den zugehörigen Identifier (<parameter>stringID</parameter>) zu kennen, stattdessen kann man diese Methode benutzen: <programlisting role="php"> <![CDATA[ $tr->setLang('it'); // Übersetze die italienische Zeichenkette "gennaio" ins englische "january" $stringID = $tr->getStringID('gennaio', 'calendar'); echo $translatedString = $tr->get($stringID, 'calendar', 'en'); ]]> </programlisting> </para> </refsect1> <refsect1 id="package.internationalization.translation2.intro.example5"> <title>Parameter-Ersetzung</title> <para> <classname>Translation2</classname> kann mit parameterisierten Zeichneketten umgehen und Parameter zur Laufzeit ersetzen. Dazu können assoziative oder numerische Arrays benutzt werden. <programlisting role="php"> <![CDATA[ // "hello_user" = "hello &&user&&, today is &&weekday&&, &&day&&th &&month&& &&year&&" $tr->setParams(array( 0 => '', 'user' => 'Joe', 'day' => '15', 'month' => $tr->get('month_01', 'calendar', 'en'), 'year' => '2004', 'weekday' => $tr->get('day_5', 'calendar', 'en') )); echo $tr->get('hello_user'); // Diese Zeile wird ausgeben: "hello Joe, today is Friday, 15th January 2004" ]]> </programlisting> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.pear.doc (#7659) next »