[DOCUMENTATION] German:

- sync up to r17890

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@17905 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/de/module_specs/Zend_Filter-Set.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17618 -->
+<!-- EN-Revision: 17887 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.filter.set" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -91,22 +91,8 @@
     </sect2>
 
     <xi:include href="Zend_Filter-RealPath.xml" />
-
-    <sect2 id="zend.filter.set.stringtolower">
-        <title>StringToLower</title>
-        <para>
-            Gibt den String <varname>$value</varname> zurück und konvertiert alphabetische Zeichen
-            zu Kleinschreibung wenn das notwendig ist.
-        </para>
-    </sect2>
-
-    <sect2 id="zend.filter.set.stringtoupper">
-        <title>StringToUpper</title>
-        <para>
-            Gibt den String <varname>$value</varname> zurück und konvertiert alphabetische Zeichen
-            zu Großschreibung wenn das notwendig ist.
-        </para>
-    </sect2>
+    <xi:include href="Zend_Filter-StringToLower.xml" />
+    <xi:include href="Zend_Filter-StringToUpper.xml" />
 
     <sect2 id="zend.filter.set.stringtrim">
         <title>StringTrim</title>

documentation/manual/de/module_specs/Zend_Filter-StringToLower.xml

@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 17887 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.stringtolower">
+    <title>StringToLower</title>
+
+    <para>
+        Dieser Filter konvertiert alle Eingabe so das Sie kleingeschrieben sind.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StringToLower();
+
+print $filter->filter('SAMPLE');
+// gibt "sample" zurück
+]]></programlisting>
+
+    <para>
+        Standardmäßig behandelt er nur Zeichen aus dem aktuellen Gebietsschema des eigenen Servers.
+        Zeichen von anderen Zeichensets werden ignoriert. Trotzdem ist es möglich auch diese, mit
+        der mbstring Erweiterung kleinzuschreiben, wenn diese in der eigenen Umgebung vorhanden ist.
+        Es muß einfach die gewünschte Kodierung, bei der Initialisierung des
+        <classname>StringToLower</classname> Filters, angegeben werden. Oder man kann die
+        <methodname>setEncoding()</methodname> Methode verwenden, um die kodierung im Nachhinein zu
+        ändern.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+// Verwendung von UTF-8
+$filter = new Zend_Filter_StringToLower('UTF-8');
+
+// Oder ein Array angeben was bei der Verwendung einer
+// Konfiguration nützlich sein kann
+$filter = new Zend_Filter_StringToLower(array('encoding' => 'UTF-8'));
+
+// Oder im Nachinein
+$filter->setEncoding('ISO-8859-1');
+]]></programlisting>
+
+    <note>
+        <title>Falsche Kodierungen setzen</title>
+
+        <para>
+            Man sollte darauf achten das man eine Exception bekommt wenn man eine Kodierung setzt,
+            solange die mbstring Erweiterung in der eigenen Umgebung nicht vorhanden ist.
+        </para>
+
+        <para>
+            Auch wenn man eine Kodierung setzt, welche von der mbstring Erweiterung nicht
+            unterstützt wird, erhält man eine Exception.
+        </para>
+    </note>
+</sect2>

documentation/manual/de/module_specs/Zend_Filter-StringToUpper.xml

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 17887 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.stringtoupper">
+    <title>StringToUpper</title>
+
+    <para>
+        Dieser Filter konvertiert alle Eingaben so das Sie großgeschrieben sind.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StringToUpper();
+
+print $filter->filter('Sample');
+// gibt "SAMPLE" zurück
+]]></programlisting>
+
+    <para>
+        So wie der <classname>StringToLower</classname> Filter kann dieser Filter nur jene Zeichen
+        behandeln welche vom aktuellen Gebietsschema des eigenen Servers unterstützt werden. Die
+        Verwendung anderer Zeichensets funktioniert genauso wie bei
+        <classname>StringToLower</classname>.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StringToUpper(array('encoding' => 'UTF-8'));
+
+// oder im Nachhinein
+$filter->setEncoding('ISO-8859-1');
+]]></programlisting>
+</sect2>

documentation/manual/de/module_specs/Zend_Filter_Input.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17618 -->
+<!-- EN-Revision: 17871 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.filter.input">
     <title>Zend_Filter_Input</title>
@@ -423,12 +423,35 @@ $m = $input->getUnescaped('month'); // nicht kommentieren
                 <para>
                     Wie oben gezeigt, kann man unkommentierte Werte erhalten undem die
                     <methodname>getUnescaped()</methodname> Methode verwendet wird, aber man muß
-                    dafür Code schreiben um die Werte sicher zu verwendetn, und
+                    dafür Code schreiben um die Werte sicher zu verwenden, und
                     Sicherheitsprobleme, wie Verletzbarkeit für Seitenübergreifende Skript Attacken
                     zu vermeiden.
                 </para>
             </note>
 
+            <warning>
+                <title>Ungeprüfte Felder escapen</title>
+
+                <para>
+                    Wie vorher erwähnt gibt <methodname>getEscaped()</methodname> nur geprüfte
+                    Felder zurück. Felder die keine zugeordnete Prüfung haben können auf diesem Weg
+                    nicht empfangen werden. Trotzdem gibt es einen möglichen Weg. Man kann eine
+                    leere Prüfung für alle Felder hinzufügen.
+                </para>
+
+                <programlisting language="php"><![CDATA[
+$validators = array('*' => array());
+
+$input = new Zend_Filter_Input($filters, $validators, $data, $options);
+]]></programlisting>
+
+                <para>
+                    Aber es sei gewarnt das die Verwendung dieser Schreibweise eine Sicherheitslücke
+                    eröffnet welche für Cross-Site Scripting Attacken verwendet werden könnte.
+                    Deswegen sollte man immer individuelle Prüfungen für jedes Feld setzen.
+                </para>
+            </warning>
+
             <para>
                 Es kann ein anderer Filter für das auskommentieren von Werten definiert werden,
                 durch seine Spezifikation im Array der Optionen des Konstruktors:

documentation/manual/de/module_specs/Zend_Log-Writers-Mail.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 17875 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.log.writers.mail">
     <title>In Emails schreiben</title>

documentation/manual/de/module_specs/Zend_Log-Writers-Syslog.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17624 -->
+<!-- EN-Revision: 17880 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.log.writers.syslog">
     <title>In das Systemlog schreiben</title>

documentation/manual/de/module_specs/Zend_Validate-Messages.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17230 -->
+<!-- EN-Revision: 17874 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.messages">
 
@@ -15,7 +15,7 @@
 
     <table id="zend.validate.messages.table">
         <title>Vorhandene Prüfmeldungen</title>
-        <tgroup cols="4">
+        <tgroup cols="3">
             <thead>
                 <row>
                     <entry>Prüfung</entry>
@@ -97,10 +97,6 @@
                     <entry>'%value%' does not appear to be a valid date</entry>
                 </row>
                 <row>
-                    <entry><constant>NOT_YYYY_MM_DD</constant></entry>
-                    <entry>'%value%' is not of the format YYYY-MM-DD</entry>
-                </row>
-                <row>
                     <entry morerows="1" valign="middle">Db_Abstract</entry>
                     <entry><constant>ERROR_NO_RECORD_FOUND</constant></entry>
                     <entry>No record matching %value% was found</entry>

documentation/manual/de/module_specs/Zend_Validate-Migration.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17471 -->
+<!-- EN-Revision: 17874 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.migration">
 
@@ -61,5 +61,86 @@ My_Validator extends Zend_Validate_Abstract
 }
 ]]></programlisting>
         </sect3>
+
+        <sect3 id="zend.validate.migration.fromoneninetooneten.datevalidator">
+            <title>Vereinfachungen im Date Prüfer</title>
+
+            <para>
+                Vor Zend Framework 1.10 wurden 2 identische Nachrichten im Date Prüfer geworfen.
+                Es gab <constant>NOT_YYYY_MM_DD</constant> und <constant>FALSEFORMAT</constant>.
+                Ab Zend Framework 1.10 wird nur mehr die <constant>FALSEFORMAT</constant> Meldung
+                zurückgegeben wenn das angegebene Datum mit dem gesetzten Format nicht
+                übereinstimmt.
+            </para>
+        </sect3>
+
+        <sect3 id="zend.validate.migration.fromoneninetooneten.barcodevalidator">
+            <title>Fehlerbehebungen im Alpha, Alum und Barcode Prüfer</title>
+
+            <para>
+                Vor dem Zend Framework 1.10 waren Nachrichten in den 2 Barcode Adaptern, dem Alpha
+                und dem Alnum Prüfer identisch. Das führte zu Problemen bei der Verwendung von
+                eigenen Meldungen, Übersetzungen oder mehreren Instanzen dieser Prüfer.
+            </para>
+
+            <para>
+                Mit Zend Framework 1.10 wurden die Werte dieser Konstanten so geändert das Sie
+                eindeutig sind. Wenn man, so wie es im Handbuhc erklärt wird, die Konstanten
+                verwendet gibt es keine Änderungen. Aber wenn man den Inhalt der Konstanten im
+                eigenen Code verwendet dann muß man diese Ändern. Die folgende Tabelle zeigt die
+                geänderten Werte:
+            </para>
+
+            <table id="zend.validate.messages.table">
+                <title>Vorhandenen Meldungen der Prüfer</title>
+                <tgroup cols="3">
+                    <thead>
+                        <row>
+                            <entry>Prüfer</entry>
+                            <entry>Konstante</entry>
+                            <entry>Wert</entry>
+                        </row>
+                    </thead>
+
+                    <tbody>
+                        <row>
+                            <entry>Alnum</entry>
+                            <entry><constant>STRING_EMPTY</constant></entry>
+                            <entry>alnumStringEmpty</entry>
+                        </row>
+
+                        <row>
+                            <entry>Alpha</entry>
+                            <entry><constant>STRING_EMPTY</constant></entry>
+                            <entry>alphaStringEmpty</entry>
+                        </row>
+
+                        <row>
+                            <entry>Barcode_Ean13</entry>
+                            <entry><constant>INVALID</constant></entry>
+                            <entry>ean13Invalid</entry>
+                        </row>
+
+                        <row>
+                            <entry>Barcode_Ean13</entry>
+                            <entry><constant>INVALID_LENGTH</constant></entry>
+                            <entry>ean13InvalidLength</entry>
+                        </row>
+
+                        <row>
+                            <entry>Barcode_UpcA</entry>
+                            <entry><constant>INVALID_LENGTH</constant></entry>
+                            <entry>upcaInvalidLength</entry>
+                        </row>
+
+                        <row>
+                            <entry>Digits</entry>
+                            <entry><constant>STRING_EMPTY</constant></entry>
+                            <entry>digitsStringEmpty</entry>
+                        </row>
+                    </tbody>
+                </tgroup>
+            </table>
+        </sect3>
     </sect2>
 </sect1>