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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 21740 -->
   3 <!-- Reviewed: no -->
   4 <sect2 id="zend.validate.set.ip">
   5     <title>Ip</title>
   6
   7     <para>
   8         <classname>Zend_Validate_Ip</classname> erlaubt es zu Prüfen ob ein gegebener Wert eine IP
   9         Adresse ist. Er unterstützt den IPv4 und auch den IPv6 Standard.
  10     </para>
  11
  12     <sect3 id="zend.validate.set.ip.options">
  13         <title>Unterstützte Optionen für Zend_Validate_Ip</title>
  14
  15         <para>
  16             Die folgenden Optionen werden für <classname>Zend_Validate_Ip</classname> unterstützt:
  17         </para>
  18
  19         <itemizedlist>
  20             <listitem>
  21                 <para>
  22                     <emphasis><property>allowipv4</property></emphasis>: Definiert ob die Prüfung
  23                     IPv4 Adressen erlaubt. Diese Option ist standardmäßig <constant>TRUE</constant>.
  24                 </para>
  25             </listitem>
  26
  27             <listitem>
  28                 <para>
  29                     <emphasis><property>allowipv6</property></emphasis>: Definiert ob die Prüfung
  30                     IPv6 Adressen erlaubt. Diese Option ist standardmäßig <constant>TRUE</constant>.
  31                 </para>
  32             </listitem>
  33         </itemizedlist>
  34     </sect3>
  35
  36     <sect3 id="zend.validate.set.ip.basic">
  37         <title>Grundsätzliche Verwendung</title>
  38
  39         <para>
  40             Ein einfaches Beispiel für die Verwendung ist anbei:
  41         </para>
  42
  43         <programlisting language="php"><![CDATA[
  44 $validator = new Zend_Validate_Ip();
  45 if ($validator->isValid($ip)) {
  46     // IP scheint gültig zu sein
  47 } else {
  48     // IP ist ungültig; Gründe ausgeben
  49 }
  50 ]]></programlisting>
  51
  52         <note>
  53             <title>Ungültige IP Adressen</title>
  54
  55             <para>
  56                 Es ist zu beachten das <classname>Zend_Validate_Ip</classname> nur IP Adressen
  57                 prüft. Adressen wie 'mydomain.com' oder '192.168.50.1/index.html' sind keine
  58                 gültigen IP Adressen. Sie sind entweder Hostnamen oder gültige
  59                 <acronym>URL</acronym>s, aber keine IP Adressen.
  60             </para>
  61         </note>
  62
  63         <note>
  64             <title>IPv6 Prüfung</title>
  65
  66             <para>
  67                 <classname>Zend_Validate_Ip</classname> prüft IPv6 Adressen mit einer Regex. Der
  68                 Grund ist, dass die Filter und Methoden von <acronym>PHP</acronym> der RFC nicht
  69                 folgen. Viele andere vorhandene Klassen folgen Ihr auch nicht.
  70             </para>
  71         </note>
  72     </sect3>
  73
  74     <sect3 id="zend.validate.set.ip.singletype">
  75         <title>IPv4 oder IPv6 alleine prüfen</title>
  76
  77         <para>
  78             Manchmal ist es nützlich nur eines der unterstützten Formate zu prüfen. Zum Beispiel
  79             wenn das eigene Netzwert nur IPv4 unterstützt. In diesem Fall wäre es sinnlos IPv6
  80             in der Prüfung zu erlauben.
  81         </para>
  82
  83         <para>
  84             Um <classname>Zend_Validate_Ip</classname> auf ein Protokoll zu begrenzen kann man die
  85             Optionen <property>allowipv4</property> oder <property>allowipv6</property> auf
  86             <constant>FALSE</constant> setzen. Man kann das durchführen indem die Option entweder im
  87             Constructor angegeben wird, oder indem <methodname>setOptions()</methodname> im
  88             Nachhinein verwendet wird.
  89         </para>
  90
  91         <programlisting language="php"><![CDATA[
  92 $validator = new Zend_Validate_Ip(array('allowipv6' => false);
  93 if ($validator->isValid($ip)) {
  94     // IP scheint eine gültige IPv4 Adresse zu sein
  95 } else {
  96     // IP ist keine IPv4 Adresse
  97 }
  98 ]]></programlisting>
  99
 100         <note>
 101             <title>Standard Verhalten</title>
 102
 103             <para>
 104                 Das Standardverhalten dem <classname>Zend_Validate_Ip</classname> folgt, ist es
 105                 beide Standards zu erlauben.
 106             </para>
 107         </note>
 108     </sect3>
 109 </sect2>