[PHP-DOC] cvs: phpdoc /nl/functions http.xml

[Derick Rethans]

derick          Mon Mar 25 07:16:40 2002 EDT

  Modified files:              
    /phpdoc/nl/functions        http.xml 
  Log:
  - Whitespaced
  
  
Index: phpdoc/nl/functions/http.xml
diff -u phpdoc/nl/functions/http.xml:1.3 phpdoc/nl/functions/http.xml:1.4
--- phpdoc/nl/functions/http.xml:1.3    Sun Mar 24 19:30:33 2002
+++ phpdoc/nl/functions/http.xml        Mon Mar 25 07:16:40 2002
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
  <reference id="ref.http">
   <title>HTTP functies</title>
   <titleabbrev>HTTP</titleabbrev>
 
   <partintro>
    <simpara>
-    Met deze functies kun je de output die teruggezonden wordt naar de
-       remote browser manipuleren op het HTTP protocol niveau.
+    Met deze functies kun je de output die teruggezonden wordt naar de remote
+    browser manipuleren op het HTTP protocol niveau.
    </simpara>
   </partintro>
 
@@ -30,12 +30,11 @@
      informatie over <acronym>HTTP</acronym> headers.
     </para>
     <para>
-     De optionele <parameter>replace</parameter> parameter geeft aan
-        of de header een vorige gelijkaardige header moet vervangen, of
-        een tweede header van hetzelfde type toe moet voegen. Standaard
-        zal hij vervangen, maar als je &false; meegeeft als tweede
-        argument kun je meerdere headeers van het zelfde type forceren.
-        Bij voorbeeld:
+     De optionele <parameter>replace</parameter> parameter geeft aan of de
+     header een vorige gelijkaardige header moet vervangen, of een tweede
+     header van hetzelfde type toe moet voegen. Standaard zal hij vervangen,
+     maar als je &false; meegeeft als tweede argument kun je meerdere headeers
+     van het zelfde type forceren.  Bij voorbeeld:
      <informalexample>
       <programlisting role="php">
 <![CDATA[
@@ -46,14 +45,13 @@
      </informalexample>
     </para>
     <para>
-        Er zijn twee speciale header calls. De eerste is een header die
-        begint met de string "<literal>HTTP/</literal>" (case is onbelangrijk),
-        die wordt gebruikt om uit te zoeken welke HTTP status moet
-        worden verzonden. Bijvoorbeeld, als je Apache hebt geconfigureerd om
-        een PHP script te gebruiken om requests voor ontbrekende bestanden
-        af te handelen (door de <literal>ErrorDocument</literal> directive te
-        gebruiken), wil je er misschien voor zorgen dat je script
-        de goede status code genereert.
+     Er zijn twee speciale header calls. De eerste is een header die begint
+     met de string "<literal>HTTP/</literal>" (case is onbelangrijk), die
+     wordt gebruikt om uit te zoeken welke HTTP status moet worden verzonden.
+     Bijvoorbeeld, als je Apache hebt geconfigureerd om een PHP script te
+     gebruiken om requests voor ontbrekende bestanden af te handelen (door de
+     <literal>ErrorDocument</literal> directive te gebruiken), wil je er
+     misschien voor zorgen dat je script de goede status code genereert.
      <informalexample>
       <programlisting role="php">
 <![CDATA[
@@ -65,20 +63,19 @@
      </informalexample>
      <note>
       <para>
-          Als je de return status op deze manier wil instellen moet je
-          zorgen dat dit de eerste header is die je verstuurt. Vergeet niet
-          dat <function>setcookie</function> <function>header</function> 
-          intern gebruikt en dat de sessie functies misschien proberen
-          om een cookie neer te zetten, zodat deze interfereren met het
-          instellen van een return status via 
-          <literal>header("HTTP ...")</literal>.
+       Als je de return status op deze manier wil instellen moet je zorgen dat
+       dit de eerste header is die je verstuurt. Vergeet niet dat
+       <function>setcookie</function> <function>header</function> intern
+       gebruikt en dat de sessie functies misschien proberen om een cookie
+       neer te zetten, zodat deze interfereren met het instellen van een
+       return status via <literal>header("HTTP ...")</literal>.
       </para>
      </note>
      <note>
       <para>
-          In PHP 3 werkt dit alleen als PHP is gecompileerd als een
-          Apache module. Je kunt echter hetzelfde effect verkrijgen
-          door middel van het gebruiken van de 
+       In PHP 3 werkt dit alleen als PHP is gecompileerd als een Apache
+       module. Je kunt echter hetzelfde effect verkrijgen door middel van het
+       gebruiken van de 
        <literal>Status</literal> header.
        <informalexample>
         <programlisting role="php">
@@ -91,10 +88,10 @@
      </note>
     </para>
     <para>
-        De tweede speciale case is de "Location:" header. Deze header wordt
-        niet alleen teruggestuurd naar de browser, maar hij geeft ook een 
-     <literal>REDIRECT</literal> (302) status code aan de browser tenzij 
-     een <literal>3xx</literal> status code al eerder werd ingesteld.
+     De tweede speciale case is de "Location:" header. Deze header wordt niet
+     alleen teruggestuurd naar de browser, maar hij geeft ook een
+     <literal>REDIRECT</literal> (302) status code aan de browser tenzij een
+     <literal>3xx</literal> status code al eerder werd ingesteld.
      <informalexample>
       <programlisting role="php">
 <![CDATA[
@@ -108,11 +105,11 @@
      <para>
       HTTP/1.1 heeft een absolute <acronym>URI</acronym> als argument voor
       <ulink url="&spec.http1.1;-sec14.html#sec14.30">Location:</ulink>,
-         inclusief het schema, de hostname en absoluut pad, maar sommige
-         clients accepteren relatieve URIs. Je kunt normaal
-      <literal>$_SERVER['HTTP_HOST']</literal>, 
<literal>$_SERVER['PHP_SELF']</literal>
-      en <function>dirname</function> gebruiken om zelf een
-         absolute URI te maken van een relatieve:
+      inclusief het schema, de hostname en absoluut pad, maar sommige clients
+      accepteren relatieve URIs. Je kunt normaal
+      <literal>$_SERVER['HTTP_HOST']</literal>,
+      <literal>$_SERVER['PHP_SELF']</literal> en <function>dirname</function>
+      gebruiken om zelf een absolute URI te maken van een relatieve:
       <informalexample>
        <programlisting>
 <![CDATA[
@@ -125,11 +122,11 @@
      </para>
     </note>
     <para>
-        PHP scripts genereren vaak dynamische content die niet mag worden
-        gecached door de client browser of een proxy cache tussen de server
-        en de client browser. Je kunt veel proxies en clients kunnen forceren
-        het cachen uit te zetten met
-          <informalexample>
+     PHP scripts genereren vaak dynamische content die niet mag worden
+     gecached door de client browser of een proxy cache tussen de server en de
+     client browser. Je kunt veel proxies en clients kunnen forceren het
+     cachen uit te zetten met
+     <informalexample>
       <programlisting role="php">
 <![CDATA[
 header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");    // Datum in het verleden
@@ -143,30 +140,29 @@
      </informalexample>
      <note>
       <para>
-          Het zou kunnen dat je pagina's zelfs niet worden gecached als je 
-          niet alle headers hierboven meestuurt. Er zijn een aantal opties
-          die gebruikers zelf kunnen instellen voor hun browser die ervoor
-          zorgen dat hun standaard caching gedrag verandert. Door de bovenstaande
-          headers mee te sturen kun je alle instellingen die anders zorgen dat
-          de output van je script wordt gecached overschrijven.
+       Het zou kunnen dat je pagina's zelfs niet worden gecached als je niet
+       alle headers hierboven meestuurt. Er zijn een aantal opties die
+       gebruikers zelf kunnen instellen voor hun browser die ervoor zorgen dat
+       hun standaard caching gedrag verandert. Door de bovenstaande headers
+       mee te sturen kun je alle instellingen die anders zorgen dat de output
+       van je script wordt gecached overschrijven.
       </para>
       <para>
-          Bovendien kunnen de <function>session_cache_limiter</function>
-          en de <literal>session.cache_limiter</literal> configuratie
-          worden gebruikt om automatisch de correcte caching-gerelateerde
-          headers mee te sturen wanneer er sessies worden gebruikt.
+       Bovendien kunnen de <function>session_cache_limiter</function> en de
+       <literal>session.cache_limiter</literal> configuratie worden gebruikt
+       om automatisch de correcte caching-gerelateerde headers mee te sturen
+       wanneer er sessies worden gebruikt.
       </para>
      </note>
     </para>
     <para>
-        Onthoud dat <function>header</function> moet worden aangeroepen
-        voor er output is verzonden, door normale HTML tags, lege regels in een
-        file, of vanuit PHP. Het is een veel voorkomende fout
-        om met <function>include</function>,
-     <function>require</function>, functies, of een andere file toegang
-     functie output te verzenden voordat <function>header</function>
-        wordt aangeroepen. Hetzelfde probleem bestaat wanneer
-        er een enkele PHP/HTML file wordt gebruikt.
+     Onthoud dat <function>header</function> moet worden aangeroepen voor er
+     output is verzonden, door normale HTML tags, lege regels in een file, of
+     vanuit PHP. Het is een veel voorkomende fout om met
+     <function>include</function>, <function>require</function>, functies, of
+     een andere file toegang functie output te verzenden voordat
+     <function>header</function> wordt aangeroepen. Hetzelfde probleem bestaat
+     wanneer er een enkele PHP/HTML file wordt gebruikt.
      <informalexample>
       <programlisting role="php">
 <![CDATA[
@@ -180,22 +176,22 @@
      </informalexample>
      <note>
       <para>
-          In PHP 4 kun je output buffering gebruiken om dit probleem te voorkomen,
-          waarbij het begin van al je output naar de browser wordt gebuffered
-          op de server tot je het verzendt. Je kunt dit doen door 
-       <function>ob_start</function> en <function>ob_end_flush</function>
-       aan te roepen in je script, of door de <literal>output_buffering</literal>
-          instelling in je <filename>php.ini</filename> of je server configuratie
-          files in te stellen.
+       In PHP 4 kun je output buffering gebruiken om dit probleem te
+       voorkomen, waarbij het begin van al je output naar de browser wordt
+       gebuffered op de server tot je het verzendt. Je kunt dit doen door
+       <function>ob_start</function> en <function>ob_end_flush</function> aan
+       te roepen in je script, of door de <literal>output_buffering</literal>
+       instelling in je <filename>php.ini</filename> of je server configuratie
+       files in te stellen.
       </para>
      </note>
     </para>    
     <para>
-        Als je wil dat de gebruiker wordt gevraagd de data die je zendt
-        op te slaan, zoals een gegenereerd PDF bestand, kun je de 
-     <ulink url="&url.rfc2183;">Content-Disposition</ulink> header gebruiken
-        om een standaard filenaam mee te geven en de browser te forceren de
-        opslaan dialoog te laten zien.
+     Als je wil dat de gebruiker wordt gevraagd de data die je zendt op te
+     slaan, zoals een gegenereerd PDF bestand, kun je de <ulink
+     url="&url.rfc2183;">Content-Disposition</ulink> header gebruiken om een
+     standaard filenaam mee te geven en de browser te forceren de opslaan
+     dialoog te laten zien.
      <informalexample>
       <programlisting role="php">
 <![CDATA[
@@ -209,16 +205,15 @@
      </informalexample>
      <note>
       <para>
-          Er is een bug in Microsoft Internet Explorer 4.01 die ervoor
-          zorgt dat dit niet werkt. Er is niks aan te doen. Er is ook een
-          bug in Microsoft Internet Explorer 5.5 dat hiermee
-          problemen veroorzaakt. Deze kan worden opgelost door up te graden
-          naar Service Pack 2 of later.
+       Er is een bug in Microsoft Internet Explorer 4.01 die ervoor zorgt dat
+       dit niet werkt. Er is niks aan te doen. Er is ook een bug in Microsoft
+       Internet Explorer 5.5 dat hiermee problemen veroorzaakt. Deze kan
+       worden opgelost door up te graden naar Service Pack 2 of later.
       </para>
      </note>
     </para>
     <para>
-        Zie ook: <function>headers_sent</function>,
+     Zie ook: <function>headers_sent</function>,
      <function>setcookie</function>, en de sectie over 
      <link linkend="features.http-auth">HTTP authenticatie</link>.
     </para>
@@ -237,8 +232,8 @@
       <void/>
      </methodsynopsis>
     <para>
-        Deze functie geeft &true; terug als de HTTP headers al zijn verzonden,
-        anders &false;
+     Deze functie geeft &true; terug als de HTTP headers al zijn verzonden,
+     anders &false;
     </para>
     <para>
      Zie ook: <function>header</function>
@@ -263,56 +258,54 @@
       <methodparam 
choice="opt"><type>int</type><parameter>secure</parameter></methodparam>
      </methodsynopsis>
     <para>
-     <function>setcookie</function> defineert een cookie dat wordt
-        meegezonden met de rest van de header informatie. Cookies
-        moeten worden verzonden <emphasis>voordat</emphasis> 
-        enige andere headers worden verzonden (dit is een restrictie
-        van cookies, niet van PHP). Daarom moet je deze functie aanroepen
-        voor enige <literal>&lt;html></literal> of
+     <function>setcookie</function> defineert een cookie dat wordt meegezonden
+     met de rest van de header informatie. Cookies moeten worden verzonden
+     <emphasis>voordat</emphasis> enige andere headers worden verzonden (dit
+     is een restrictie van cookies, niet van PHP). Daarom moet je deze functie
+     aanroepen voor enige <literal>&lt;html></literal> of
      <literal>&lt;head></literal> tags.
     </para>
     <para>
-        Alle argumenten behalve de <parameter>name</parameter> parameter
-        zijn optioneel. Als alleen het name argument aanwezig is, wordt
-        het cookie met die naam verwijderd van de remote client. Je mag
-        een willekeurig argument ook vervangen door een lege string
-     (<emphasis>&quot;&quot;</emphasis>) om dat argument over te slaan.
-        De <parameter>expire</parameter> en <parameter>secure</parameter>
-        argumenten zijn integers en kunnen niet worden overgeslagen
-        met een lege string. Gebruik in plaats daarvan een nul
-     (<emphasis>0</emphasis>). De <parameter>expire</parameter> parameter
-        is een normaal Unix tijds integer zoals wordt teruggegeven door de
-        <function>time</function> of <function>mktime</function> functies.
-        De <parameter>secure</parameter> geeft aan dat het cookie alleen
-        mag worden verzonden over een veilige HTTPS verbinding.
+     Alle argumenten behalve de <parameter>name</parameter> parameter zijn
+     optioneel. Als alleen het name argument aanwezig is, wordt het cookie met
+     die naam verwijderd van de remote client. Je mag een willekeurig argument
+     ook vervangen door een lege string (<emphasis>&quot;&quot;</emphasis>) om
+     dat argument over te slaan.  De <parameter>expire</parameter> en
+     <parameter>secure</parameter> argumenten zijn integers en kunnen niet
+     worden overgeslagen met een lege string. Gebruik in plaats daarvan een
+     nul (<emphasis>0</emphasis>). De <parameter>expire</parameter> parameter
+     is een normaal Unix tijds integer zoals wordt teruggegeven door de
+     <function>time</function> of <function>mktime</function> functies.  De
+     <parameter>secure</parameter> geeft aan dat het cookie alleen mag worden
+     verzonden over een veilige HTTPS verbinding.
     </para>
     <para>
      Veel voorkomende fouten:
      <itemizedlist>
       <listitem>
        <simpara>
-           Cookies worden niet zichtbaar tot de volgende keer dat een pagina 
-               waarop het cookie zichtbaar is wordt geladen.
+        Cookies worden niet zichtbaar tot de volgende keer dat een pagina
+        waarop het cookie zichtbaar is wordt geladen.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
-           Cookies moeten worden verwijderd met dezelfde parameters als waarmee
-               ze werden ingesteld.
+        Cookies moeten worden verwijderd met dezelfde parameters als waarmee
+        ze werden ingesteld.
        </simpara>
       </listitem>
      </itemizedlist>
     </para>
     <simpara>
-        In PHP 3 worden meerdere aanroepen van <function>setcookie</function>
-        in hetzelfde script verwerkt in omgekeerde volgorde. Als je probeert
-        een cookie te verwijderen voordat je een nieuwe neerzet, moet je het
-        toevoegen doen voor het verwijderen. In PHP 4 worden meerdere
-        aanroepen van <function>setcookie</function> verwerkt in de volgorde
-        waarop ze worden aangeroepen.
+     In PHP 3 worden meerdere aanroepen van <function>setcookie</function> in
+     hetzelfde script verwerkt in omgekeerde volgorde. Als je probeert een
+     cookie te verwijderen voordat je een nieuwe neerzet, moet je het
+     toevoegen doen voor het verwijderen. In PHP 4 worden meerdere aanroepen
+     van <function>setcookie</function> verwerkt in de volgorde waarop ze
+     worden aangeroepen.
     </simpara>
     <para>
-        Een paar voorbeelden volgen over hoe je cookies moet verzenden:
+     Een paar voorbeelden volgen over hoe je cookies moet verzenden:
      <example>
       <title><function>setcookie</function> stuur voorbeelden</title>
       <programlisting role="php">
@@ -325,10 +318,10 @@
      </example>
     </para>
     <para>
-        Wanneer je een cookie verwijdert moet je zorgen dat de expiratie
-        datum in het verleden is, om het verwijder mechanisme in je browser
-        te activeren. Er volgen voorbeelden hoe je in het vorige voorbeeld
-        verzonden cookies kunt verwijderen:
+     Wanneer je een cookie verwijdert moet je zorgen dat de expiratie datum in
+     het verleden is, om het verwijder mechanisme in je browser te activeren.
+     Er volgen voorbeelden hoe je in het vorige voorbeeld verzonden cookies
+     kunt verwijderen:
      <example>
       <title><function>setcookie</function> verwijder voorbeelden</title>
       <programlisting role="php">
@@ -341,12 +334,12 @@
      </example>
     </para>
     <para>
-        Let er op dat het waarde deel van het cookie automatisch wordt
-        ge-urlencoded wanneer je het cookie verzendt, en wanneer het wordt
-        ontvangen, wordt het automatisch gedecodeerd en toegewezen aan
-        een variabele met dezelfde naam als de cookie naam. Om de inhoud
-        van ons test cookie in een script te zien, kun je simpelweg een
-        van de volgende voorbeelden gebruiken:
+     Let er op dat het waarde deel van het cookie automatisch wordt
+     ge-urlencoded wanneer je het cookie verzendt, en wanneer het wordt
+     ontvangen, wordt het automatisch gedecodeerd en toegewezen aan een
+     variabele met dezelfde naam als de cookie naam. Om de inhoud van ons test
+     cookie in een script te zien, kun je simpelweg een van de volgende
+     voorbeelden gebruiken:
      <informalexample>
       <programlisting role="php">
 <![CDATA[
@@ -357,11 +350,11 @@
      </informalexample>
     </para>
     <para>
-        Je kunt ook array cookies zetten door array notatie in de cookie
-        naam te gebruiken. Dit heeft het effect dat er evenveel cookies
-        worden neergezet als je array elements hebt, maar als het cookie
-        wordt ontvangen door je script worden de waarden allemaal geplaatst
-        in een array met de naam van het cookie:
+     Je kunt ook array cookies zetten door array notatie in de cookie naam te
+     gebruiken. Dit heeft het effect dat er evenveel cookies worden neergezet
+     als je array elements hebt, maar als het cookie wordt ontvangen door je
+     script worden de waarden allemaal geplaatst in een array met de naam van
+     het cookie:
      <informalexample>
       <programlisting role="php">
 <![CDATA[
@@ -378,18 +371,18 @@
      </informalexample>
     </para>
     <para>
-        Voor meer informatie over cookies, zie Netscape's cookie
+     Voor meer informatie over cookies, zie Netscape's cookie
      specificatie op <ulink
      url="&spec.cookies;">&spec.cookies;</ulink>.
     </para>
     <simpara>
-     Microsoft Internet Explorer 4 met Service Pack 1 werkt niet
-        goed met cookies die hun path parameter hebben ingesteld.
+     Microsoft Internet Explorer 4 met Service Pack 1 werkt niet goed met
+     cookies die hun path parameter hebben ingesteld.
     </simpara>
     <simpara>
-     Netscape Communicator 4.05 en Microsoft Internet Explorer 3.x
-        lijken cookies incorrect af te handelen wanneer het pad en de
-        tijd niet zijn ingesteld.
+     Netscape Communicator 4.05 en Microsoft Internet Explorer 3.x lijken
+     cookies incorrect af te handelen wanneer het pad en de tijd niet zijn
+     ingesteld.
     </simpara>
    </refsect1>
   </refentry>