svn: /phpdoc/de/trunk/reference/network/functions/ header.xml headers-sent.xml ip2long.xml long2ip.xml setcookie.xml setrawcookie.xml

Modified: phpdoc/de/trunk/reference/network/functions/header.xml
===================================================================
--- phpdoc/de/trunk/reference/network/functions/header.xml	2018-02-05 15:24:25 UTC (rev 344180)
+++ phpdoc/de/trunk/reference/network/functions/header.xml	2018-02-05 16:57:47 UTC (rev 344181)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 335374 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343909 Maintainer: sammywg Status: ready -->

 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.header">
  <refnamediv>
@@ -12,8 +12,8 @@
   &reftitle.description;
   <methodsynopsis>
    <type>void</type><methodname>header</methodname>
-   <methodparam><type>string</type><parameter>string</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>replace</parameter><initializer>true</initializer></methodparam>
+   <methodparam><type>string</type><parameter>header</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>replace</parameter><initializer>&true;</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>http_response_code</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -53,7 +53,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>string</parameter></term>
+     <term><parameter>header</parameter></term>
      <listitem>
       <para>
        Der Header-String.
@@ -133,7 +133,7 @@
      <listitem>
       <para>
        Forciert einen HTTP-Response-Code des angegebenen Wertes. Dieser Parameter
-       hat nur einen Effekt, wenn <parameter>string</parameter> nicht leer ist.
+       hat nur einen Effekt, wenn <parameter>header</parameter> nicht leer ist.
       </para>
      </listitem>
     </varlistentry>
@@ -283,10 +283,11 @@
   </note>
   <note>
    <para>
-    HTTP/1.1 verlangt einen absoluten <acronym>URI</acronym> inklusive dem
-    Schema, Hostnamen und absoluten Pfad als Argument
-    von <link xlink:href="&spec.http1.1;#section-7.1.2">Location:</link>,
-    aber manche Clients akzeptieren auch relative URIs. Gewöhnlich können
+    Die meisten zeitgemäßen Clients akzeptieren relative <acronym>URI</acronym>s
+    als Argument für <link
+    xlink:href="&spec.http1.1;#section-7.1.2">Location:</link>, aber einige
+    ältere Clients benötigen einen absoluten URI inklusive dem
+    Schema, Hostnamen und absoluten Pfad. Gewöhnlich können
     Sie mittels <varname>$_SERVER['HTTP_HOST']</varname>,
     <varname>$_SERVER['PHP_SELF']</varname> und <function>dirname</function>
     aus einem relativen Link einen absoluten URI selbst erstellen:
@@ -323,6 +324,7 @@
     <member><function>headers_sent</function></member>
     <member><function>setcookie</function></member>
     <member><function>http_response_code</function></member>
+    <member><function>header_remove</function></member>
     <member>
      The section on <link linkend="features.http-auth">HTTP
      authentication</link>

Modified: phpdoc/de/trunk/reference/network/functions/headers-sent.xml
===================================================================
--- phpdoc/de/trunk/reference/network/functions/headers-sent.xml	2018-02-05 15:24:25 UTC (rev 344180)
+++ phpdoc/de/trunk/reference/network/functions/headers-sent.xml	2018-02-05 16:57:47 UTC (rev 344181)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 334605 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 341282 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.headers-sent" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>headers_sent</refname>
@@ -77,7 +77,7 @@
     exit;
 }

-// Ein Beispiel für den Einsatz der seit PHP 4.3.0 verfügbaren optionalen
+// Ein Beispiel für den Einsatz der optionalen
 // Parameter file und line. Beachten Sie, dass $filename und $linenum für
 // einen späteren Einsatz übergeben werden.
 // Weisen Sie ihnen davor keine Werte zu.

Modified: phpdoc/de/trunk/reference/network/functions/ip2long.xml
===================================================================
--- phpdoc/de/trunk/reference/network/functions/ip2long.xml	2018-02-05 15:24:25 UTC (rev 344180)
+++ phpdoc/de/trunk/reference/network/functions/ip2long.xml	2018-02-05 16:57:47 UTC (rev 344181)
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 334621 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 342153 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.ip2long" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ip2long</refname>
-  <refpurpose>Verwandelt eine gemäß IPv4-Protokoll angegebene Internet-Adresse
-     vom Punkt-Format in die ausgeschriebene Adress-Angabe</refpurpose>
+  <refpurpose>Wandelt eine gemäß IPv4-Protokoll angegebene Internet-Adresse
+     vom Punkt-Format in ein long integer</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -16,8 +16,7 @@
   </methodsynopsis>
   <para>
    Die Funktion <function>ip2long</function> erzeugt aus einer im
-   Punkt-Format angegebenen IPv4-Adresse eine ausgeschriebene
-   Adress-Angabe.
+   Punkt-Format angegebenen IPv4-Adresse ein long integer.
   </para>
   <para>
    <function>ip2long</function> funktioniert auch mit unvollständigen
@@ -46,7 +45,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Gibt die IPv4-Adresse zurück. Ist <parameter>ip_address</parameter> ungültig,
+   Gibt ein long integer zurück. Ist <parameter>ip_address</parameter> ungültig,
    wird &false; zurückgegeben.
   </para>
  </refsect1>
@@ -64,6 +63,14 @@
      </thead>
      <tbody>
       <row>
+       <entry>5.5.0</entry>
+       <entry>
+        Vor dieser Version lieferte <function>ip2long</function> unter Windows
+        bisweilen eine gültige Zahl zurück, selbst wenn ein Wert übergeben
+        wurde, der keine (IPv4) Internet-Protocol-Adresse im Punkt-Format war.
+       </entry>
+      </row>
+      <row>
        <entry>5.2.10</entry>
        <entry>
         Vor dieser Version gab <function>ip2long</function> manchmal eine
@@ -99,7 +106,7 @@
     <title>Eine IP-Adresse anzeigen</title>
     <para>
      Das zweite Beispiel zeigt, wie eine konvertierte Adresse mittels
-     <function>printf</function> sowohl in PHP4 als auch in PHP 5 ausgegeben
+     <function>printf</function> ausgegeben
      werden kann:
     </para>
     <programlisting role="php">
@@ -111,8 +118,8 @@
 if ($long == -1 || $long === FALSE) {
     echo 'Ungültige IP, versuchen Sie es noch einmal';
 } else {
-    echo $ip   . "\n";           // 192.0.34.166
-    echo $long . "\n";           // -1073732954
+    echo $ip   . "\n";            // 192.0.34.166
+    echo $long . "\n";            // 3221234342 (-1073732954 auf 32-bit Systemen aufgrund des Integer-Überlaufs)
     printf("%u\n", ip2long($ip)); // 3221234342
 }
 ?>
@@ -136,9 +143,10 @@
   <note>
    <para>
     <function>ip2long</function> gibt in PHP 5 &lt;= 5.0.2 für die IP-Adresse
-    <literal>255.255.255.255</literal> &false; zurück. Der Fehler wurde in
-    PHP 5.0.3 gefixt, so dass wieder <literal>-1</literal> zurückgegeben
-    wird (ebenso wie in PHP 4).
+    <literal>255.255.255.255</literal> &false;, und <literal>-1</literal> auf 64-bit Systemen in PHP 5 &lt;=5.2.4 zurück. Der Fehler wurde in
+    PHP 5.2.25 gefixt, so dass wieder <literal>4294967295</literal> zurückgegeben
+    wird. 32-bit System geben <literal>-1</literal> aufgrund des
+    Integer-Überlaufs zurück.
    </para>
   </note>
  </refsect1>

Modified: phpdoc/de/trunk/reference/network/functions/long2ip.xml
===================================================================
--- phpdoc/de/trunk/reference/network/functions/long2ip.xml	2018-02-05 15:24:25 UTC (rev 344180)
+++ phpdoc/de/trunk/reference/network/functions/long2ip.xml	2018-02-05 16:57:47 UTC (rev 344181)
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 342916 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.long2ip" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>long2ip</refname>
-  <refpurpose>Konvertiert eine (IPv4) Netzwerkadresse in einen String,
-     der das Punkt-Format enthält ("Dotted-Format")</refpurpose>
+  <refpurpose>Konvertiert eine long integer Adresse in einen String,
+     der das (IPv4) Punkt-Format enthält ("Dotted-Format")</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -12,12 +12,12 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>long2ip</methodname>
-   <methodparam><type>string</type><parameter>proper_address</parameter></methodparam>
+   <methodparam><type>int</type><parameter>proper_address</parameter></methodparam>
   </methodsynopsis>
   <para>
    Die Funktion <function>long2ip</function> erzeugt eine Internet
-   Adresse im Punkt-Format (also: www.xxx.yyy.zzz) anhand einer
-   richtigen - ausgeschriebenen - Adress-Angabe.
+   Adresse im Punkt-Format (also: www.xxx.yyy.zzz) anhand der
+   long integer Adresse.
   </para>
  </refsect1>

@@ -29,7 +29,7 @@
      <term><parameter>proper_address</parameter></term>
      <listitem>
       <para>
-       Eine korrekte Adressrepräsentation.
+       Eine korrekte Adressrepräsentation als long integer.
       </para>
      </listitem>
     </varlistentry>
@@ -44,6 +44,41 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>7.1.0</entry>
+      <entry>
+       Der Parametertyp von <parameter>proper_address</parameter> wurde von
+       <type>string</type> zu <type>int</type> geändert.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="notes"><!-- {{{ -->
+  &reftitle.notes;
+  <note>
+   <para>
+    Auf 32-bit Architekturen ergibt die Umwandlung von Integer-Repräsentationen
+    von IP-Adresssen von <type>string</type> zu <type>integer</type> keine
+    richtigen Ergebnisse für Zahlen, die <constant>PHP_INT_MAX</constant>
+    überschreiten.
+   </para>
+  </note>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

Modified: phpdoc/de/trunk/reference/network/functions/setcookie.xml
===================================================================
--- phpdoc/de/trunk/reference/network/functions/setcookie.xml	2018-02-05 15:24:25 UTC (rev 344180)
+++ phpdoc/de/trunk/reference/network/functions/setcookie.xml	2018-02-05 16:57:47 UTC (rev 344181)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 330583 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.setcookie" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -13,12 +13,12 @@
   <methodsynopsis>
    <type>bool</type><methodname>setcookie</methodname>
    <methodparam><type>string</type><parameter>name</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>value</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>value</parameter><initializer>""</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>expire</parameter><initializer>0</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>path</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>domain</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>secure</parameter><initializer>false</initializer></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>httponly</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>path</parameter><initializer>""</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>domain</parameter><initializer>""</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>secure</parameter><initializer>&false;</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>httponly</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>setcookie</function> definiert ein mit den HTTP
@@ -32,12 +32,8 @@
   </para>
   <para>
    Sind die Cookies einmal gesetzt, können Sie beim nächsten Seitenaufruf
-   anhand der <varname>$_COOKIE</varname> oder
-   <varname>$HTTP_COOKIE_VARS</varname> Arrays auf diese zugreifen.
-   Beachten Sie, dass die <link
-   linkend="language.variables.superglobals">Superglobals</link> wie
-   <varname>$_COOKIE</varname> seit PHP 4.1.0 verfügbar sind.
-   Die Cookie-Werte stehen auch in <varname>$_REQUEST</varname>.
+   anhand des <varname>$_COOKIE</varname> Arrays auf diese zugreifen.
+   Die Cookie-Werte können auch in <varname>$_REQUEST</varname> vorhanden sein.
   </para>
  </refsect1>

@@ -44,14 +40,6 @@
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
-   Alle Argumente außer <parameter>name</parameter> sind optional. Sie können
-   ein Argument auch mit einem leeren String (<emphasis>&quot;&quot;</emphasis>)
-   ersetzen, wenn Sie es übergehen wollen. Da der
-   <parameter>expire</parameter>-Parameter einen Integer-Wert darstellt, kann
-   er nicht durch die Angabe eines Leerstrings übersprungen werden, verwenden
-   Sie daher statt dessen die Null (<emphasis>0</emphasis>).
-  </para>
-  <para>
    <link xlink:href="&url.rfc;6265">RFC 6265</link> liefert die normative
    Referenz wie die jeweiligen <function>setcookie</function> Parameter
    interpretiert werden.
@@ -121,12 +109,15 @@
      <term><parameter>domain</parameter></term>
      <listitem>
       <para>
-       Die Domain, der das Cookie zur Verfügung steht. Wird die Domain auf
-       <literal>'www.example.com'</literal> gesetzt, ist das Cookie in der
-       <literal>www</literal> Subdomain und in höheren Subdomains verfügbar.
-       Cookies die in einer niedrigeren Subdomain verfügbar sind, wie
-       <literal>'example.com'</literal>, sind in höheren Subdomains verfügbar,
-       wie <literal>'www.example.com'</literal>.
+       Die (Sub)-Domain, der das Cookie zur Verfügung steht. Wird dies auf eine
+       Subdomain (wie <literal>'www.example.com'</literal>) gesetzt, dann steht
+       dieser Subdomain und allen anderen Subdomains davon (z.B.
+       w2.www.example.com) das Cookie zur Verfügung. Um das Cookie der ganzen
+       Domain zur Verfügung zu stellen (einschließlich aller Subdomains davon),
+       muss der Wert einfach auf den Domainnamen (in diesem Fall
+       <literal>'example.com'</literal>) gesetzt werden.
+      </para>
+      <para>
        Ältere Browser, die noch immer das veraltete
        <link xlink:href="&url.rfc;2109">RFC 2109</link> implementieren, können
        ein führendes <literal>.</literal> benötigen, um alle Subdomains
@@ -212,7 +203,6 @@
 <?php
 // ein bestimmtes Cookie ausgeben
 echo $_COOKIE["TestCookie"];
-echo $HTTP_COOKIE_VARS["TestCookie"];

 // Ein anderer Weg zu Debuggen/Testen ist, alle Cookies anzuzeigen
 print_r($_COOKIE);
@@ -235,8 +225,8 @@
 <![CDATA[
 <?php
 // Setzen des Verfalls-Zeitpunktes auf 1 Stunde in der Vergangenheit
-setcookie ("TestCookie", "", time() - 3600);
-setcookie ("TestCookie", "", time() - 3600, "/~rasmus/", "example.com", 1);
+setcookie("TestCookie", "", time() - 3600);
+setcookie("TestCookie", "", time() - 3600, "/~rasmus/", "example.com", 1);
 ?>
 ]]>
     </programlisting>

Modified: phpdoc/de/trunk/reference/network/functions/setrawcookie.xml
===================================================================
--- phpdoc/de/trunk/reference/network/functions/setrawcookie.xml	2018-02-05 15:24:25 UTC (rev 344180)
+++ phpdoc/de/trunk/reference/network/functions/setrawcookie.xml	2018-02-05 16:57:47 UTC (rev 344181)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 330583 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343899 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.setrawcookie" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>setrawcookie</refname>
@@ -16,8 +16,8 @@
    <methodparam choice="opt"><type>int</type><parameter>expire</parameter><initializer>0</initializer></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>path</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>domain</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>secure</parameter><initializer>false</initializer></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>httponly</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>secure</parameter><initializer>&false;</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>httponly</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>setrawcookie</function> ist exakt das Gleiche wie